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Android 系统 是 目前 最 为 流行 的 智能 手机 操作 系统 之 一 ， 面 向 Android 系统 的 应 用 开发 是 目前 的 技术 热 
点 。 本 书 针对 Android SDK 7， 结 合 全 新 的 Android Studio 开发 环境 ,对 Android 应 用 编程 基础 知识 进行 讲解 ， 
易于 读者 理论 联系 实践 ， 尽 快 掌握 Android 系统 编程 知识 。 

本 书 分 为 14 章 ， 使 用 Java 开发 语言 ， 内 容 主 要 包括 Android 系统 的 发 展 历史 、 系 统 架 构 、 应 用 程序 框 
架 、 界 面 开 发 、 网 络 访问 、 多 媒体 应 用 程序 开发 、 数 据 存储 等 。 本 书 每 一 章 都 给 出 实例 ， 使 读者 进一步 巩固 
所 学 的 知识 ， 提 高 综合 实战 能 力 。 

本 书 既 适合 熟悉 Java 编程 的 Android 初学 者 和 具有 一 定 Android 编程 经 验 的 用 户 ， 也 可 供 广大 计算 机 工 
作者 和 软件 开发 者 参考 。 
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自 2007 年 5 月 Android 开源 手机 平台 问世 以 来 ， 已 经 经 历 了 10 多 年 的 发 展 。 这 期 间 ， 基 于 
Android 平台 的 智能 手机 迅速 占领 市 场 ， 成 为 当前 最 受 欢 迎 的 手机 操作 系统 之 一 。 随 之 而 来 的 是 基 
于 Android 操作 系统 的 应 用 程序 需求 多 元 化 ，Android 开发 技术 成 为 市 场 求职 的 新 宠 。 

为 了 帮助 国内 开发 人 员 快 速 掌握 Android 开发 技术 ， 获 取 更 好 的 就 业 机 会 ， 笔 者 基于 Google 
公司 2016 年 5 月 发 布 的 Android SDK 7.0 (API Level 24) 编写 了 本 书 ， 希 望 能 够 帮助 广大 读者 在 
Android 开发 的 道路 上 入 门 并 且 获 得 提高 。 本 书 在 编写 时 综合 考虑 了 自学 和 教学 两 方面 因素 。 本 书 
不 仅 适合 高 校 教学 ， 还 适合 学 生 自学 ， 同 时 也 适合 有 一 定 开 发 经 验 的 程序 员 作为 参考 书 使 用 。 


本 书 内 容 


本 书 共 分 为 14 章 ， 由 浅 入 深 地 讲解 了 Android 开发 的 各 个 方面 。 本 书 在 讲解 过 程 中 穿插 大 量 
实例 ， 希 望 借 此 帮助 读者 更 好 地 理解 Android 开发 的 过 程 ， 并 获得 提高 。 

本 书 的 前 3 章 为 基础 内 容 ， 系 统 地 介绍 了 Android 系统 的 诞生 和 发 展 的 过 程 、Android 的 系统 
框架 、Android 开发 环境 的 搭建 以 及 Android 应 用 程序 的 基本 组 件 ， 并 且 着 重 讲解 了 Android 系统 
中 人 机 交互 的 基本 组 件 Activity 的 基本 知识 。 

第 4 章 讲解 了 Android 开发 过 程 中 界面 开发 相关 的 知识 , 包括 在 用 户 界面 设计 过 程 中 常用 的 布 
局 和 组 件 、Android N 的 多 窗口 和 通知 分 组 等 新 特性 以 及 Android 处 理 人 机 交互 事件 的 方法 。 

第 5 章 讲 解 了 Intent 的 基本 知识 ， 并 利用 Intent 实现 了 电话 和 短信 应 用 程序 开发 功能 。 

第 6 章 主要 讲解 了 Android 系统 下 的 多 媒体 开发 技术 , 实现 了 音频 和 视频 的 播放 。 通过 Service 
和 BroadcastReceiver 实现 了 后 台 音 频 播放 的 相关 功能 , 通过 Android 提供 的 硬件 编程 API 实现 了 自 
己 的 录像 和 拍照 应 用 程序 。 

第 7 章 讲解 了 Android 系统 提供 的 4 种 数据 存储 方式 ， 分 别 为 SharedPreferences、 文 件 存储 、 
数据 库存 储 和 ContentProvider。 活 用 这 些 数据 存储 方式 ， 实 现 数据 持久 化 ， 是 应 用 程序 开发 过 程 中 
不 可 回避 的 问题 。 

第 8 章 讲解 了 网 络 编程 的 相关 知识 ， 包 括 HITP 编程 、Socket 编程 、Bluetooth 编程 和 WIFI 
编程 等 。 

第 9 章 解决 了 利用 Google 提供 的 Google Map API 开发 自己 的 位 置 服务 应 用 的 方法 。 

第 10 章 讲 解 了 Android SDK 提供 的 绘图 API, 包括 2D 绘图 和 3D 绘图 两 个 方面 。 绘 图 技术 是 
动画 制作 和 游戏 开发 的 重要 技术 。 

第 11 章 讲解 了 Android 系统 应 用 程序 开发 的 国际 化 和 本 地 化 技术 ， 借 助 于 该 技术 ， 可 以 使 
发 人 员 开 发 的 应 用 程序 不 需要 做 任何 修改 就 可 以 在 全 球 任意 地 区 正常 运行 。 

第 12 章 讲解 了 Android 7 提供 的 文本 服务 ， 主 要 介绍 如 何 使 用 系统 提供 的 剪贴 板 功能 。 
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第 13 章 讲解 了 Android 7 的 企业 应 用 开发 技术 ， 包 括 设备 管理 API、 文 本 语音 API、TV 应 用 
开发 和 可 穿戴 技术 几 部 分 。 

第 14 章 讲解 了 应 用 程序 发 布 的 相关 知识 ， 包 括 应 用 程序 签名 的 策略 、 签 名 文件 的 生成 、 如 何 
对 应 用 程序 签名 以 及 如 何 发 布 到 Google Play Store。 正 确 地 发 布 自己 开发 的 应 用 程序 是 利用 Android 
技术 赚 取 第 一 桶 金 的 前 提 条 件 。 

由 于 本 书 篇 幅 有 限 ,不 可 能 将 Android SDK 7 的 相关 知识 全 部 讲解 , 读者 可 以 参阅 Android SDK 
文档 获取 更 多 信息 。 














配套 示例 源 代码 下 载 


为 了 方便 读者 学 习 ， 本 书 中 使 用 的 相关 示例 源 代码 可 以 从 下 面 的 地 址 下 载 : 
https://pan.baidu.com/s/1fTg7gJsqD9_9eWWOMOnbTQ (密码 : tfh2) 


或 者 扫描 右边 的 二 维 码 下 载 。 
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Android 系统 概述 


1.1 智能 手机 


1.1.1 什么 是 智能 手机 


智能 手机 (Smart Phone) 是 指 “ 像 个 人 电脑 一 样 具 有 独立 的 操作 系统 ， 可 以 由 用 户 自 行 安装 
软件 、 游 戏 等 第 三 方 服务 商 提 供 的 程序 ， 通 过 此 类 程序 来 不 断 对 手机 的 功能 进行 扩充 ， 并 可 以 通过 
移动 通信 网 络 来 实现 无 线 网 络 接 入 ”的 这 样 一 类 手机 的 总 称 。 

“智能 手机 ”这 个 说 法 主要 是 针对 “功能 手机 (Feature Phone) ”而 言 的 ， 本 身 并 不 意味 着 这 
个 手机 有 多 “智能 ”; 从 另 一 个 角度 来 讲 ， 所 谓 的 “智能 手机 ”就 是 一 台 可 以 像 电脑 那样 随意 安装 
和 和 镍 载 应 用 软件 的 手机 ， 而 “功能 手机 ” 则 不 能 。Java 的 出 现 使 后 来 的 “功能 手机 ”具备 了 安装 
Java 应 用 程序 的 功能 ， 但 是 Java 应 用 程序 的 操作 友好 性 、 运 行 效率 及 对 系统 资源 的 使 用 情况 都 比 
“智能 手机 ” 差 了 很 多 。 

智能 手机 具有 五 大 特点 : 

(1) 具备 无 线 接 入 互联 网 的 能 力 ， 即 需要 支持 GSM 网 络 下 的 GPRS 或 者 CDMA 网 络 的 CDMA 
1X 或 3G (WCDMA, CDMA-EVDO, TD-SCDMA) 网 络 , 甚至 是 4G (HSPA+ FDD-LTE, TDD-LTE) 
网 络 。 

(2) 具有 PDA 的 功能 ， 包 括 PIM (个 人 信息 管理 ) 、 日 程 记 事 、 任 务 安排 、 多 媒体 应 用 、 
浏览 网 页 。 

(3) 具有 开放 性 的 操作 系统 ， 可 以 安装 更 多 的 应 用 程序 ， 使 智能 手机 的 功能 可 以 得 到 无 限 扩展 。 

(4) 人 性 化 ， 可 以 根据 个 人 需要 扩展 机 器 功能 。 
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(5) 功能 强大 ， 扩 展 性 强 ， 第 三 方 软件 支持 多 。 


智能 手机 比 传统 的 手机 具有 更 多 的 综合 性 处 理 能 力 ， 与 传统 手机 外 观 和 操作 方式 类 似 ， 但 是 
传统 手机 使 用 的 是 生产 厂商 自行 开发 的 封闭 式 操作 系统 ， 所 能 实现 的 功能 非常 有 限 ， 不 具备 智能 手 
机 的 扩展 性 。 





1.1.2 智能 手机 操作 系统 


智能 手机 是 一 种 在 手机 内 安装 了 相应 开放 式 操作 系统 的 手机 ， 随 着 通信 技术 的 发 展 ， 尤 其 是 
第 三 代 移动 通信 技术 3G) 的 逐步 成 熟 ， 市 场 上 对 功能 更 强 、 扩 展 性 能 更 好 的 智能 手机 的 需求 量 
增长 迅 狐 。 具备 独立 的 操作 系统 是 智能 手机 最 重要 的 特征 。 智 能 手机 操作 系统 是 一 种 运算 能 力 及 功 
E 比 传统 功能 手机 系统 更 强 的 手机 系统 。 智 能 手机 操作 系统 领域 也 是 各 大 手机 厂商 争夺 的 焦点 。 目 
前 ， 主 流 的 智能 手机 操作 系统 主要 有 Symbian OS、Windows Phone、iOS、Palm OS、BlackBerry OS 
和 Android 六 种 。 

各 系统 的 特点 如 下 。 

1. Symbian OS 

塞 班 操作 系统 (Symbian OS) 最 初 是 由 Symbian 公司 〈 诺 基 亚 、 索 尼 爱 立信 、 摩 托 罗 拉 、 西 
门 子 等 几 家 大 型 移动 通信 设备 商 共同 出 资 组 建 的 一 个 合资 公司 ， 专 门 研发 手机 操作 系统 ) 开发 的 ， 
其 前 身 是 Psion 公司 推出 的 EPOC (Electronic Piece of Cheese) 操作 系统 ， 是 专门 用 于 智能 手机 和 
移动 设备 的 32 位 抢占 式 、 多 任务 操作 系统 。 其 内 核 与 GUI (Graphical User Interface， 图 形 用 户 界 
面 ， 又 称 图 形 用 户 接口 ) 分 开 ， 功 耗 低 、 占 用 内 存 少 。 

Symbian 操作 系统 在 智能 移动 终端 上 拥有 强大 的 应 用 程序 以 及 通信 能 力 这 都 要 归功 于 它 有 一 
个 非常 健全 的 、 核 心 强大 的 对 象 导 向 系统 、 企 业 用 标准 通信 传输 协议 以 及 完美 的 Sun Java 语言 。 
Symbian 认为 无 线 通信 装置 除了 要 提供 声音 沟通 的 功能 外 ， 同 时 也 应 具有 其 他 种 类 的 沟通 方式 ， 如 
触 笔 、 键 盘 等 。 在 硬件 设计 上 ， 它 可 以 提供 许多 不 同 风格 的 外 形 ， 比 如 提供 真实 或 虚拟 的 键盘 ， 在 
软件 功能 上 可 以 容纳 许多 功能 ， 包 括 和 他 人 分 享 信息 ， 浏 览 网 页 ， 发 送 、 接 收 电子 邮件 和 传真 ， 以 
及 个 人 生活 行程 管理 ， 等 等 。 此 外 ，Symbian 操作 系统 在 扩展 性 方面 为 制造 商 预 留 了 多 种 接口 ， 而 
H EPOC 操作 系统 还 可 以 细 分 成 三 种 类 型 : Pearl、Quartz 和 Crystal， 分 别 对 应 普通 手机 、 智 能 手 
机 和 Hand Held PC 场合 的 应 用 。 

塞 班 操作 系统 为 第 三 方 开 发 商 提供 一 个 标准 和 开放 的 平台 环境 。 使 得 第 三 方 应 用 程序 的 设计 
者 能 够 基于 该 平台 开发 自己 的 应 用 软件 。 这 种 方式 带 来 的 不 足 之 处 是 , 由 于 第 三 方 厂商 的 用 户 接口 
程序 是 不 同 的， 造成 了 软件 不 能 通用 ,扩展 性 较 差 。 这 使 得 塞 班 操作 系统 在 办 公 软 件 和 多 媒体 录放 
软件 上 没有 开发 出 足够 多 的 软件 供用 户 使 用 。 

多 年 来 ， Symbian 系统 一 直 占 据 智能 系统 的 市 场 霸主 地 位 ， 系 统 能 力 和 易 用 性 方面 均 很 出 色 ， 
但 是 在 Android 系统 出 现 后 ，Symbian 系统 的 市 场 占有 率 急剧 下 降 。 

2. Windows Phone 


Windows Phone 最 早 叫 Windows Mobile (简称 WM) ， 是 微软 针对 移动 设备 而 开发 的 操作 系统 。 
该 操作 系统 的 设计 初衷 是 尽量 接近 桌面 版 本 的 Windows， 微 软 按照 电脑 操作 系统 的 模式 来 设计 
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WM, 应 用 软件 以 Microsoft Win32 API 为 基础 。2010 年 10 月 ，Windows Phone 操 作 系 统 正式 发 布 后 ， 
Windows Mobile 系 列 正式 退出 手机 系统 市 场 。 

微软 公司 正式 发 布 了 智能 手机 操作 系统 Windows Phone， 同 时 将 谷歌 的 Android 和 苹果 的 10S 
列 为 主要 竞争 对 手 。2011 年 2 月 ， 诺 基 亚 与 微软 达成 全 球 战略 同盟 并 深度 合作 共同 研发 。2012 年 
3 月 21 H, Windows Phone 7.5 登陆 中 国 。6 月 21 日 ， 微 软 正式 发 布 最 新 手机 操作 系统 Windows 
Phone 8, Windows Phone 8 采用 和 Windows 8 相同 的 内 核 。 

Windows Phone 具有 桌面 定制 、 图 标 拖 忠 、 滑 动 控制 等 一 系列 前 卫 的 操作 体验 , 其 主屏 幕 通过 
提供 类 似 仪表 盘 的 体验 来 显示 新 的 电子 邮件 、 短 信 、 未 接 来 电 、 日 历 约会 等 ， 让 人 们 对 重要 信息 保 
持 时 刻 更 新 。 它 还 包括 一 个 增强 的 触摸 屏 界面 ， 更 方便 手指 操作 ， 以 及 一 个 最 新 版 本 的 正 Mobile 
浏览 器 ， 该 浏览 器 在 一 项 由 微软 赞助 的 第 三 方 调查 研究 中 ， 和 参与 调研 的 其 他 手机 浏览 器 相 比 ， 可 
以 执行 指定 任务 的 比例 高 达 48%。 很 容易 看 出 微软 在 用 户 操作 体验 上 所 做 出 的 努力 ， 而 史 带 夫 “* 鲍 
尔 默 也 表示 : “全 新 的 Windows 手机 把 网 络 、 个 人 电脑 和 手机 的 优势 集 于 一 身 ， 让 人 们 可 以 随时 
随地 享受 到 想 要 的 体验 。” 

3. iOS 


iOS E 2011 年 6 月 前 叫 iPhone OS， 是 苹果 公司 为 其 移动 设备 开发 的 操作 系统 ， 最 初 是 设计 
给 iPhone 和 iPod Touch 使 用 的 。 与 Mac OS X 操作 系统 一 样 ， 它 也 是 以 Darwin 为 基础 的 。2011 
年 6 月 之 后 ，iOS 的 版 本 为 5 和 6， 通常 称 为 iOS 5 和 iOS 6. 

苹果 推出 其 第 一 款 智 能 手机 iPhone 后 获得 了 巨大 的 成 功 。 iOS 继承 了 Mac OS X 在 个 人 电脑 
上 界面 美观 的 优势 ， 多 点 触摸 技术 的 加 入 为 iPhone 在 智能 手机 领域 获得 了 可 观 的 市 场 份额 。iOS 
采用 Quartz 图 形 框架 ， 能 够 通过 显卡 硬件 加 速 实现 复杂 的 图 形 显示 。 然 而 iOS 是 一 个 不 开放 的 平 
台 ， 用 户 不 能 设计 和 加 载 任何 第 三 方 的 应 用 程序 。 这 使 得 108 的 扩展 性 受到 很 大 的 限制 。 

4. Palm OS 

Palm OS 是 Palm 公司 开发 的 专用 于 PDA 上 的 一 种 操作 系统 ， 这 是 PDA 上 的 霸主 ， 一 度 占据 
了 90% 的 PDA 市 场 的 份额 。 虽 然 其 并 不 是 专门 针对 手机 设计 的 ， 但 是 Palm OS 的 优秀 性 和 对 移动 
设备 的 支持 同样 使 其 能 够 成 为 一 个 优秀 的 手机 操作 系统 。 

Palm 操作 系统 是 多 任务 的 ， 但 每 次 只 允许 一 个 应 用 程序 的 打开 ， 多 个 应 用 程序 不 能 同时 运行 ， 
这 使 得 其 运行 速度 很 快 ， 具 有 较 好 的 实用 性 ， 但 不 适应 需要 多 应 用 程序 运行 的 场合 。 

5. BlackBerry OS 


BlackBerry OS 是 RIM 公司 (Research In Motion) 专用 的 操作 系统 。“ 黑 莓 ” (BlackBerry) 
移动 邮件 设备 基于 双向 寻 呼 技术 。 该 设备 与 RIM 公司 的 服务 器 相 结合 ， 依 赖 于 特定 的 服务 器 软件 
和 终端 ， 兼 容 现 有 的 无 线 数据 链 路 ， 实 现 了 遍及 北美 、 随 时 随地 收发 电子 邮件 的 梦想 。 这 种 装置 并 
不 以 奇妙 的 图 片 和 彩色 屏幕 村人 耳目 ， 甚 至 不 带 发 声 器 。 黑 莓 是 目前 在 美国 、 加 拿 大 地 区 相当 流行 
的 无 线 收发 电子 邮件 的 软件 ， 它 将 软件 客户 端 结合 在 移动 电话 、PDA 及 其 他 通信 终端 上 ， 用 户 可 
以 通过 其 无 线装 置 来 安全 地 访问 电子 邮件 、 企 业 数据 、Web 以 及 进行 企业 内 部 的 语音 通话 。 

BlackBerry OS 具 有 多 任务 处 理 能 力 ， 并 支持 特定 的 输入 装置 ， 如 滚轮 、 轨 迹 球 、 触 摸 板 以 及 
触摸 屏 等 。BlackBeny 平 台 最 著名 的 莫 过 于 它 处 理 邮 件 的 能 力 。 该 平台 通过 MIDP 1.0 以 及 MIDP 2.0 
的 子 集 , 在 与 BlackBerry Enterprise Server 连 接 时 , 以 无 线 的 方式 激活 并 与 Microsoft Exchange, Lotus 
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Domino 或 Novell GroupWise 同 步 邮件 、 任 务 、 上 日程、 备忘录 和 联系 人 。 该 操作 系统 还 支持 WAP 1.2。 
6. Android 


Android 是 一 种 以 Linux 为 基础 的 开放 源码 操作 系统 ， 主 要 应 用 于 便携 设备 。Linux 操作 系统 
的 嵌入 式 版 本 是 为 各 种 资源 受 限 的 嵌入 式 终端 产品 设计 的 。 开 放 的 源码 和 免费 供 人 使 用 的 特点 使 得 
Linux 的 应 用 开发 人 员 非 常 丰富 。 而 越 来 越 多 的 智能 手机 开发 商 也 倾向 于 研发 Linux 智能 手机 ， 以 
此 来 降低 手机 成 本 。 相 比 于 其 他 智能 手机 操作 系统 ，Linux 独 有 的 优势 包括 以 下 4 个 方面 : 


(1) Linux 操作 系统 几乎 能 运行 在 所 有 主流 的 处 理 器 上 ， 如 X86、PowerPC、ARM 等 。 

(2) Linux 作为 一 个 多 用 户 多 任务 的 操作 系统 ， 符 合 POSIX 便携 式 计算 机 环境 操作 系统 接口 
标准 。 

(3) Linux 支持 和 鼓励 差异 ， 具 有 良好 的 开放 性 ， 使 得 用 户 可 以 构筑 适合 自己 的 系统 。 

(4) Linux 是 无 任何 附加 条 件 的 开放 平台 ， 对 硬件 平台 具有 更 好 的 适应 性 ， 可 移植 性 强 ， 允 
许 定制 用 户 界面 和 服务 ， 支 持 多 种 格式 的 可 执行 文件 等 。 


Android 操作 系统 最 初 由 Andy Rubin 开发 ， 最 初 主要 支持 手机 2005 4E, 由 Google 收购 注资 ， 
并 组 建 开 放手 机 联盟 开发 改良 ， 逐 渐 扩 展 到 平板 电脑 及 其 他 领域 。 它 采用 Linux 2.6.x 版 本 内 核 ， 
采用 自己 的 GUI 架构 和 应 用 程序 接口 ， 并 采用 Java 语言 来 开发 应 用 程序 。 它 拥有 Linux 操作 系统 
的 开放 性 、 对 硬件 支持 好 等 优点 ， 并 且 界 面 美观 ， 这 使 得 它 受到 市 场 的 普遍 欢迎 。Android 的 主要 
竞争 对 手 是 苹果 公司 的 iOS 以 及 RIM 的 BlackBerry OS. 2011 年 第 一 季度 ，Android 在 全 球 的 市 场 
份额 首次 超过 塞 班 系统 ， 跃 居 全 球 第 一 。 

Android 的 特点 是 开放 源 代码 ， 它 的 SDK 开放 给 任何 开发 商 ， 所 有 开发 商都 可 以 随意 更 改 界 面 。 


1.2 什么 是 Android 


1.2.1 Android 的 历史 


Android 一 词 最 早出 现 于 法 国 作家 利 尔 亚当 (Auguste Villiers de I'Isle-Adam) 在 1886 年 发 表 的 
科幻 小 说 《未 来 夏娃 》 CL'éve future) 中 ， 将 外 表 像 人 的 机 器 起 名 为 Android. 

Android 本 意 指 “ 机 器 人 ”， 是 一 个 全 身 绿色 的 机 器 人 ， 绿 色 也 是 Android 的 标志 。Android 
最 初 由 现任 Google 工程 副 总 裁 安 迪 。 罗 宾 (Andy Rubin) 开发 于 2003 年 ， 于 2005 年 被 Google 收 
购 。 

Android 是 基于 Linux 内 核 的 软件 平台 和 操作 系统 ， 是 Google 在 2007 年 11 月 5 日 公布 的 手 
机 系统 平台 ， 早 期 由 Google 开发 ， 后 由 开放 手机 联盟 (Open Handset Alliance) 开发 。 它 采用 了 软 
件 堆 层 (Software Stack， 又 名 以 软件 县 层 ) 的 架构 ， 主 要 分 为 三 部 分 。 底 层 以 Linux 内 核 工 作为 基 
础 ， 只 提供 基本 功能 ， 其 他 的 应 用 软件 则 由 各 公司 自行 开发 ， 以 Java 作为 编写 程序 的 一 部 分 。 
Android 在 未 公开 之 前 常 被 传闻 为 Google 电话 或 gPhone。 大 多 传闻 认为 Google 开发 的 是 自己 的 手 
机 电话 产品 ， 而 不 是 一 套 软件 平台 。 
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1.2.2 Android 的 发 展 


2003 年 10 月 ，Android 公司 在 加 州 Palo Alto 市 成 立 ， 联 合 创 始 人 为 Andy Rubin. Rich Miner, 
Nick Sear 与 Chris White。 

2005 年 8 A, Google 收购 了 成 立 仅 22 个 月 的 高 科技 企业 Android 公司 。 

2007 年 11 月 5 A, Google 公司 正式 向 外 界 展示 Android 操作 系统 。Google 与 34 家 手机 制造 
商 、 软 件 开发 商 、 电 信 运 营 商 和 芯片 制造 商 共同 创建 开放 手持 设备 联盟 。 

2008 年 5 月 28 H, Patrick Brady F Google UO 大 会 上 提出 Android HAL 架构 图 8 月 18 A, 
Android 获得 美国 联邦 通信 委员 会 的 批准 。 

Android 软件 一 经 推出 ， 版 本 升级 非常 快 ， 几 乎 每 隔 半 年 就 有 一 个 新 的 版 本 发 布 。2008 年 9 
月 发 布 Android 第 一 版 Android 1.1。 后 从 Android 1.5 版 本 开始 ，Android 用 甜点 作为 它们 系统 版 
本 代号 的 命名 方法 。 

2009 年 4 月 30 日 ,官方 1.5 版 本 Cupcake (纸杯 蛋糕 ) 正式 发 布 。 

2009 4Æ 9 115 A, Android 1.6 Donut (CHAHE) 版 本 发 布 。 

2009 年 10 月 26 H, Android 2.0/2.0.1/2.1 Eclair (RAE) 版 本 发 布 。 

2010 年 5 月 20 日 ，Android 2.2/2.2.1 Froyo CARI) 版 本 发 布 。 

2010 年 12 月 7 日 ，Android 2.3 Gingerbread (HH) 版 本 发 布 。 

2011 年 2 月 2 日 ， Android 3.0 Honeycomb CERE) 版 本 发 布 。 

2011 年 5 月 11 日 ，Android 3.1 Honeycomb (蜂巢 ) 版 本 发 布 。 

2011 年 7 月 13 日 ，Android 3.2 Honeycomb (蜂巢) 版 本 发 布 。 

2011 ££ 10 H 19 A, Android 4.0 Ice Cream Sandwich (冰激凌 三 明治 ) 版 本 在 香港 正式 发 布 。 
2011 年 12 月 20 H, 谷歌 发 布 了 Android 4.0 操作 系统 的 最 新 版 本 4.0.3， 称 其 对 Android 系统 做 出 
了 多 处 改进 ， 并 修复 了 一 些 缺 陷 。 

2012 年 6 月 28 H, 谷歌 在 2012 年 的 IO 开发 者 大 会 上 发 布 了 Android 4.1 操作 系统 ，Android 
4.1 Jelly Bean (RRT) 是 继 “ 冰 激 凌 三 明治 ”之 后 的 下 一 版 Android 系统 。 

2012 年 10 月 底 ，Google 在 网 上 以 在 线 的 形式 发 布 了 全 新 的 Android 4.2 系统 ， 以 及 新 一 代 的 
Nexus 系列 手机 LG Nexus 4 和 平板 电脑 Nexus 10. Android 4.2 新 系统 界面 改动 不 大 ， 代 号 还 称 为 
Jelly Bean， 新 增 了 系统 全 景 拍照 以 及 无 线 同步 输出 等 实用 的 小 功能 ， 并 在 系统 层面 做 了 更 多 的 优 
化 。 

2013 年 7 月 25 日 ， 发 布 Android 4.3. 

2013 年 11 月 ，Android 4.4 发 布 ， 代 号 为 KitKat。 

2014 年 10 月 16 日 ， 发 布 Android 7.0 版 本 ， 代 号 为 Nougat， 第 一 次 全 面 支持 ART， 并 支持 
平板 和 可 穿戴 设备 的 开发 。 

2015 年 3 A, Google 发 布 了 Android 5.1 版 本 ， 主 要 目的 是 修复 Android 7.0 版 本 的 Bug， 因 
此 其 版 本 号 仍然 为 Nougat。 

2015 年 5 H 8 H, Google 在 Google IO 2015 大 会 上 发 布 了 Android 6.0 版 本 ， 版 本 号 为 
Marshmallow. 

201645 H 18 H , Google Æ Google /O 2016 大 会 上 发 布 了 Android 7.0 版 本 ,版 本 号 为 Android 
Nougat， 又 称 为 Android N. 
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本 书 的 编写 就 是 基于 Android 7.0 版 本 进行 的 。 


1.2.3 Android 的 优点 


Android 的 优点 主要 包括 以 下 6 项 。 

1.Android 性 价 比 高 

消费 者 选择 产品 ， 价 格 是 必然 要 考虑 的 一 个 因素 ，iPhone 虽 好 ， 但 是 价格 让 一 般 人 望而却步 。 
苹果 就 像 是 宝马 、 奔 驰 ， 虽 然 大 家 都 认为 它 很 好 ,但 是 一 般 人 消费 不 起 ， 只 有 看 的 份 儿 。 而 Android 
如 同 大 众 ， 满 大 街 跑 的 都 是 ， 甚 至 有 一 些 型 号 是 可 以 与 宝马 、 奔 驰 相 媲美 的 。 

虽然 Android 平台 的 手机 廉价 ， 但 是 其 性 能 却 一 点 也 不 低廉 ， 触 摸 效 果 并 不 比 苹果 差 到 哪里 
去 。Android 平台 简单 实用 ， 无 论 是 功能 还 是 外 观 设 计 ， 都 可 以 与 苹果 一 决 高 下 。 在 数量 众多 的 
Android 手机 中 ， 消 费 者 总 是 会 找到 一 款 满意 的 Android 手机 取代 价格 高 昂 的 iPhone. 

2. 应 用 程序 发 展 迅速 

智能 手机 玩 的 就 是 应 用 ， 虽 然 现 在 Android 的 应 用 还 无 法 与 苹果 相 竞 争 ， 但 是 随 着 Android 的 
推广 与 普及 ， 应 用 程序 的 数量 增长 迅速 ，Android 应 用 在 可 预见 的 未 来 是 有 能 力 与 苹果 相 竞争 的 。 
而 来 自 Android 应 用 商店 最 大 的 优势 是 ， 不 对 应 用 程序 进行 严格 的 审查 。 在 这 一 点 上 优 于 苹果 。 

3. 智能 手机 厂家 助力 

现在 ， 世 界 上 很 多 智能 手机 厂家 都 加 入 了 Android 阵营 ， 并 推出 了 一 系列 的 Android 智能 机 。 
摩托 罗拉 、 三 星 、HTC、LG 等 厂家 都 与 谷歌 建立 了 Android 平台 技术 联盟 。 厂 商 加 盟 的 越 多 ， 手 
机 终端 就 会 越 多 ， 其 市 场 潜力 就 越 大 。 

4. 运营 商 易 力 支 持 

在 国内 ， 三 大 运营 商 锦 足 了 劲 推广 Android 智能 机 。 联 通 的 “0 元 购 机 ”、 电 信 的 千 元 3G、 
移动 的 索爱 A8i 定制 机 都 显示 了 运营 商 对 Android 智能 机 的 期 望 。 

在 美国 ，T-Mobile USA, Sprint, AT&T 和 Verizon 都 推出 了 Android 手机 。 此 外 ，KDDI CH 
Æ) . NTTDoCoMo (HÆ) . Telecomltalia (意大利 电信 ) ~ T-Mobile (德国 ) Telefónica (P 
班 牙 ) 等 众多 运营 商都 是 Android 的 支持 者 ， 有 这 么 多 的 运营 商 支持 Android， 自 然 会 占据 巨大 的 
市 场 份额 。 


5. 机 型 多 ， 硬 件 配置 优 


自从 Google 推出 Android 系统 以 来 ， 各 大 厂家 纷纷 推出 自己 的 Android FA FHL, HTC. 2€ 
尼 爱 立信 、 魅 族 、 摩 托 罗 拉 、 夏 普 、LG、 三 星 、 联 想 等 都 推出 了 各 自 的 Android 手机 ， 机 型 多 样 ， 
数不胜数 。 


6. 系统 开源 利于 创新 


Android 是 开源 的 ， 允 许 第 三 方 修改 ， 这 在 很 大 程度 上 容许 厂家 根据 自己 的 硬件 更 改版 本 ， 从 
而 能 够 更 好 地 适应 硬件 ， 与 之 形成 良好 的 结合 。 开 源 能 够 提供 更 好 的 安全 性 能 ， 也 给 开发 人 员 提 供 
了 一 个 更 大 的 创新 空间 ， 从 而 使 Android 版 本 升级 更 快 。 
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1.3 Android 系统 架构 





图 1.1 是 Android 操作 系统 的 架构 ， 架 构 包 括 4 层 ， 由 上 到 下 依次 是 应 用 程序 层 、 应 用 程序 框 
架 层 、 核 心 类 库 和 Linux 内 核 。 其 中 ， 核 心 类 库 中 包含 系统 库 及 Android 运行 环境 。 


APPLICATIDNS 





APPLICATION FRAMEWORK 


Content 
Providers 





ANDROID RUNTIME 


‘Core Libraries 








LINUX KERNEL 


Flash Memai Binder (IPC) 
Camera Driver meer Do 


Audio 


Power 
WIR Driver Drivers Management 





图 1.1 Android 操作 系统 的 架构 


13.1 应 用 程序 层 


Android 装配 了 一 个 核心 应 用 程序 集合 ， 包 括 E-mail 客户 端 、SMS 短 消 息 程序 、 日 历 地 图 、 
浏览 器 、 联 系 人 管理 程序 和 其 他 程序 ， 所 有 应 用 程序 都 是 用 Java 编程 语言 编写 的 。 用 户 开 发 的 
Android 应 用 程序 和 Android 的 核心 应 用 程序 是 同一 层次 的 ， 它 们 都 是 基于 Android 的 系统 API 构 
建 的 。 


1.3.2 ”应 用 程序 框架 层 


应 用 程序 的 体系 结构 则 在 简化 组 件 的 重用 ， 任 何 应 用 程序 都 能 发 布 它 的 功能 且 任 何其 他 应 用 
程序 都 可 以 使 用 这 些 功能 (需要 服从 框架 执行 的 安全 限制 ) ， 这 一 机 制 允许 用 户 蔡 换 组 件 。 开 发 者 
完全 可 以 访问 核心 应 用 程序 所 使 用 的 API 框架 。 通 过 提供 开放 的 开发 平台 ，Android 使 开发 者 能 够 
编制 极其 丰富 和 新 颖 的 应 用 程序 。 开发 者 可 以 自由 地 利用 设备 硬件 优势 访问 位 置信 息 、 运行 后 台 服 
务 、 设 置 闹钟 、 向 状态 栏 添加 通知 等 。 

所 有 的 应 用 程序 都 是 由 一 系列 的 服务 和 系统 组 成 的 ， 主 要 包括 以 下 几 种 : 
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视图 ( Views )。 这 里 的 视图 指 的 是 丰富 的 、 可 扩展 的 视图 集合 ， 可 用 于 构建 一 个 应 用 程序 ， 
包括 列表 (Lists )、 网 格 (Grids), X AGE ( TextBoxes), 442 (Buttons), & £ € Aii Web 
浏览 器 。 

内 容 管理 器 (Content Providers )。 内 容 管 理 器 使 得 应 用 程序 可 以 访问 另 一 个 应 用 程序 的 数据 
(如 联系 人 数据 库 ) 或 者 共享 自己 的 数据 。 

资源 管理 器 (Resource Manager )。 资 源 管理 器 提供 访问 非 代 码 资 源 ， 如 本 地 字符 串 、 图 形 和 
分 层 文件 (layout files )。 

通知 管理 器 (Notification Manager )。 通 知 管理 器 使 得 所 有 的 应 用 程序 都 能 够 在 状态 栏 显示 通 
知 信息 。 

活动 管理 器 (Activity Manager )。 在 大 多 数 情况 下 ， 每 个 Android 应 用 程序 都 运行 在 自己 的 
Linux 进程 中 。 当 应 用 程序 的 某 些 代码 需要 运行 时 ， 这 个 进程 就 被 创建 并 一 直 运行 下 去 ， 直 
到 系统 认为 该 进程 不 再 有 用 为 止 ， 然 后 系统 将 回收 该 进程 占用 的 内 存 以 便 分 配给 其 他 的 应 用 
程序 。 活 动 管理 器 管理 应 用 程序 生命 周期 ， 并 且 提 供 通用 的 导航 回 退 功能 。 


1.3.3 AE 


Android 本 地 框架 是 由 C/C++ 实现 的 ， 包 含 C/C++ 库 ， 以 供 Android 系统 的 各 个 组 件 使 用 。 这 
些 功能 通过 Android 的 应 用 程序 框架 为 开发 者 提供 服务 。 


这 


里 只 介绍 C/C++ 库 中 的 一 些 核心 库 : 


系统 C 库 。 标 准 C 系统 库 (libe) 的 BSD 衍生 ， 调 整 为 基于 嵌入 式 Linux 设备 。 

媒体 库 。 基 于 PacketVideo 的 OpenCORE， 这 些 库 支持 播放 和 录制 许多 流行 的 音频 和 视频 格 
式 ， 以 及 静态 图 像 文件 ， 包 括 MPEG4、H.264、MP3、AAC、AMR、JPG、PNG. 

界面 管理 。 管 理 访问 显示 子 系统 ， 并 且 为 多 个 应 用 程序 提供 2D 和 3D 图 层 的 无 终 融 合 。 
LibWebCore。 新 式 的 Web 浏览 器 引擎 ， 支 持 Android 浏览 器 和 内 嵌 的 Web 视图 。 

SGL。 一 个 内 置 的 2D 图 形 引擎 。 

3D 库 。 基 于 OpenGL ES 1.0 APIs 实现 ， 该 库 可 以 使 用 硬件 3D 加 速 或 包含 高 度 优化 的 3D 软 
FreeType。 位 图 和 矢量 字体 显示 泻 染 。 

SQLite, SQLite 是 一 个 所 有 应 用 程序 都 可 以 使 用 的 强大 且 轻 量 级 的 关系 数据 库 引擎 。 


1.3.4 Android 运行 环境 


Android 包含 一 个 核心 库 的 集合 ， 该 核心 库 提 供 了 Java 编程 语言 核心 库 的 大 多 数 功能 。 几 乎 每 
一 个 Android 应 用 程序 都 在 自己 的 进程 中 运行 ， 都 拥有 一 个 独立 的 Dalvik 虚拟 机 实例 。 

Dalvik 是 Google 公司 自己 设计 的 用 于 Android 平台 的 Java 虚拟 机 。Dalvik 虚拟 机 是 Google 
等 厂商 合作 开发 的 Android 移动 设备 平台 的 核心 组 成 部 分 之 一 。 它 可 以 支持 已 转换 为 .dex (Dalvik 
Executable) 格式 的 Java 应 用 程序 的 运行 ，.dex 格式 是 专 为 Dalvik 设计 的 一 种 压缩 格式 ， 适 合 内 存 
和 处 理 器 速度 有 限 的 系统 。Dalvik 经 过 优化 ， 允 许 在 有 限 的 内 存 中 同时 运行 多 个 虚拟 机 的 实例 ， 
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并 且 每 一 个 Dalvik 应 用 作为 一 个 独立 的 Linux 进程 执行 。Dalvik 虚拟 机 依赖 Linux. 内 核 提 供 基 本 
功能 ， 如 线程 和 底层 内 存 管理 。 


1.3.5 Linux 内 核 


Android 基于 Linux 提供 核心 系统 服务 ， 例 如 安全 、 内 存 管 理 、 进 程 管理 、 网 络 堆栈 、 驱 动 模 
型 。 除 了 标准 的 Linux 内 核 外 ，Android 还 增加 了 内 核 的 驱动 程序 ， 如 Binder (IPC) 驱动 、 显 示 驱 
动 、 输 入 设备 驱动 、 音 频 系 统 驱动 、 摄 像 头 驱 动 、WiFi 驱动 、 蓝 牙 驱 动 、 电 源 管理 。 

Linux 内 核 也 作为 硬件 和 软件 之 间 的 抽象 层 ， 它 隐藏 具体 硬件 细节 而 为 上 层 提供 统一 的 服务 。 
分 层 的 好 处 就 是 使 用 下 层 提供 的 服务 为 上 层 提供 统一 的 服务 ,屏蔽 本 层 及 以 下 层 的 差异 ， 当 本 层 及 
以 下 层 发 生 了 变化 时 ， 不 会 影响 到 上 层 ， 可 以 说 是 高 内 聚 、 低 耦合 。 


1.4 Android 7 新 特性 介绍 


Android 7.0 Nougat 是 迄今 为 止 规模 最 大 的 Android 版 本 。 该 版 本 为 用 户 推出 了 各 种 帮 新 的 功 
能 ， 为 开发 者 提供 了 数 千 个 新 的 API。 不 仅 如 此 ， 它 还 将 Android 扩展 得 更 广 ， 小 到 手机 、 平 板 电 
脑 和 穿戴 式 设备 ， 大 到 电视 和 汽车 。 

本 节 主 要 介绍 Android 7 新 增 的 几 个 特性 。 


144 分 屏 显示 


在 运行 Android 7 的 手机 和 平板 电脑 上 , 用 户 可 以 并 排 运行 
两 个 应 用 , 或 者 处 于 分 屏 模式 时 , 一 个 应 用 位 于 另 一 个 应 用 之 上 。 
用 户 可 以 通过 拖 动 两 个 应 用 之 间 的 分 隔 线 来 调整 应 用 所 占 屏 幕 
的 大 小 ， 如 图 1.2 所 示 。 


142 ”全 新 的 通知 设计 


Android 7 对 通知 栏 功能 进行 了 进一步 的 丰富 ， 使 之 速度 更 € 
快 且 更 加 易于 使 用 。 可 以 实现 通知 栏 内 容 分 组 、 通 知 样式 自 定义 、 E VEN 
通知 直接 回复 等 功能 ， 如 图 13 所 示 。 此 外 ， 借 助 于 模板 ， 开 发 
者 只 需 编写 少量 的 代码 便 可 以 实现 相关 功能 。 








更 多 连接 方式 








图 1.2 分 屏 显示 
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图 1.3 通知 直接 回复 功能 


14.3 ”基于 配置 文件 的 JIT/AOT 编译 


在 Android N 系统 中 ， 添 加 了 Justin Time (JIT) 编译 器 支持 ， 可 以 在 应 用 运行 时 对 ART 进 
行 代码 分 析 ， 持 续 提升 Android 应 用 的 性 能 。JIT 编译 器 对 Android 运行 组 件 Ahead of Time 
(AOT) 编译 器 进行 了 补充 ， 有 助 于 提升 运行 时 性 能 ， 节 省 存储 空间 ， 加 快 应 用 更 新 和 系统 更 新 
速度 。 

基于 配置 文件 的 IT/AOT 编译 可 以 让 Android N 系统 的 运行 组 件 依据 应 用 的 实际 情况 对 应 用 
进行 HT/AOT 编译 ， 有 助 于 降低 RAM 使 用 ， 降 低 耗 电量 ， 并 且 能 够 大 幅度 提升 应 用 的 安装 速度 。 


1.4.4 优化 的 低 电 耗 模 式 


Android 6.0 推出 了 低 电 耗 模式 ， 即 设备 处 于 空闲 状态 时 ， 通 过 推迟 应 用 的 CPU 和 网 络 活动 
以 实现 省 电 目 的 的 系统 模式 ， 例 如 设备 放 在 桌 上 或 抽 居 里 时 。Android N 将 低能 耗 模 式 更 加 推进 了 
一 步 ， 只 要 屏幕 关闭 了 一 段 时 间 ,， 且 设备 未 插入 电源 ， 低 电 耗 模式 就 会 对 应 用 使 用 熟悉 的 CPU 和 
网 络 限制 。 这 意味 着 用 户 即 使 将 设备 放 入 口袋 里 也 可 以 省 电 。 




















1.4.5 Project Svelte: 后 台 优化 


Android N 系统 持续 改善 了 Project Svelte ， 以 最 大 程度 地 减少 Android 设备 中 一 系列 系统 和 
应 用 使 用 的 RAM. 
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此 外 ,在 Android N 中 ， 删 除了 三 个 常用 的 隐 式 广播 : CONNECTIVITY ACTION. 
ACTION NEW PICTURE 和 ACTION NEW VIDEO。 因为 这 些 广播 可 能 会 一 次 唤醒 多 个 应 用 的 


后 台 进程 ， 同 时 会 耗 尽 内 存 和 电池 。 


1.4.6 Data Saver 


在 移动 设备 的 整个 生命 周期 ， 蜂 窝 数 据 计 划 的 成 本 通常 





会 超出 设备 本 身 的 成 本 。 对 于 许多 用 户 而 言 ， 蜂 窟 数据 是 他 


们 想 要 节省 的 昂贵 资源 。 


Android N 推出 了 Data Saver 系统 服务 ( 见 图 1.4) ， 有 
助 于 减少 应 用 使 用 的 蜂窝 数据 ， 无 论 是 在 漫游 、 账 单 周期 即 
将 结束 , 还 是 使 用 少量 的 预付 费 数据 包 。Data Saver 让 用 户 可 
以 控制 应 用 使 用 蜂窝 数据 的 方式 ， 同 时 让 开发 者 打开 Data 


Saver 时 可 以 提供 更 多 有 效 的 服务 。 


此 外 ,Android N 扩展 了 ConnectivityManager， 以 便 为 应 


€ Data Saver 





用 检索 用 户 的 Data Saver 首选 项 并 监控 首选 项 变更 。 所 有 应 图 1.4 Data Saver 
用 均 应 检查 用 户 是 否 已 启用 Data Saver 并 努力 限制 前 台 和 后 


台 的 流量 消耗 。 
1.4.7 Quick Settings Tile API 


快速 设置 贴 片 通常 用 于 直接 从 通知 栏 显示 关键 设 
置 和 操作 ， 如 图 L5 所 示 。 在 Android N 中 ,扩展 了 
快速 设置 贴 片 的 范围 ， 使 其 使 用 更 加 方便 。 

Android N 为 快速 设置 贴 片 添加 了 更 多 空间 用 户 
可 以 通过 向 左 或 向 右 滑 动 跨 分 页 的 显示 区 域 访问 它 
们 。 用 户 可 以 控制 显示 哪些 快速 设置 贴 片 ， 并 且 可 以 
通过 拖 放 贴 片 来 添加 或 移动 贴 片 位 置 。 

Android N 为 开发 者 提供 了 新 的 API， 以 定义 自 
己 的 快速 设置 贴 片 ， 进 而 使 用 户 能 够 轻松 访问 应 用 中 
的 关键 控件 和 操作 。 


14.8 ”号码 屏蔽 和 来 电 过 滤 


Android 7.0 对 号 码 屏 蔽 和 来 电 过 渡 功 能 提供 了 平 
台 级 别 的 支持 ， 并 提供 了 相关 的 API。 系 统 会 形成 一 
个 号 码 屏蔽 列表 ， 系 统 默认 的 短信 应 用 、 系 统 应 用 和 




















10:30AM，Mon, Jan 4 


图 1.5 快速 设置 贴 片 


服务 提供 商 开发 的 应 用 可 以 访问 该 列表 ， 而 其 他 应 用 不 具有 访问 该 列表 的 权限 。 
来 电 过 滤 功 能 除了 会 拒绝 来 电 呼 入 之 外 ， 还 可 以 将 来 电 记录 到 系统 日 志 ， 并 且 不 向 用 户 发 送 
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来 电 通知 。 借助 号 码 屏 蔽 列表 还 可 以 完成 短信 屏蔽 、 跨 设备 使 用 该 列表 、 多 应 用 共用 该 列表 等 功能 。 


1.4.9 OpenGL ES 3.2API 支持 


Android 7.0 支持 Khronos OpenGL ES 3.1, 因此 开发 者 可 以 在 受 支持 的 设备 上 为 游戏 和 其 他 应 
用 采用 最 高 性 能 的 2D 和 3D 图 形 功能 。 

OpenGL ES 32 增加 了 计算 着 色 器 、 模 板 纹理 、 加 速 的 视觉 效果 、 优 化 ETC2/EAC 纹理 压缩 、 
高 级 纹理 泻 染 、 标 准 化 纹理 尺寸 以 及 泻 染 缓冲 区 格式 等 功能 ， 针 对 HDR 的 浮 点 帧 缓冲 和 延迟 着 
色 进 行 了 优化 ， 并 通过 强大 的 缓冲 区 访问 控制 减少 了 WebGL 开销 。 

Android 7.0 还 支持 Android 扩展 程序 包 (AEP) ， 这 是 一 组 OpenGL ES 扩展 程序 ， 可 让 开发 
者 使 用 镶嵌 图 案 着 色 器 、 几 何 图 形 着 色 器 、ASTC 纹理 压缩 、 按 样本 插入 和 着 色 以 及 其 他 高 级 泻 染 
功能 。 有 了 AEP， 开 发 者 就 可 以 通过 一 系列 GPU 运用 高 性 能 图 形 。 








1.4.10” 密 钥 认 证 


Android 7.0 使 用 硬件 支持 的 密 钥 库 ， 可 更 安全 地 在 Android 设备 上 创建 、 存 储 和 使 用 加 密 密 
钥 。 它 们 可 保护 Linux 内 核 免 受 潜在 的 Android 漏洞 的 攻击 ， 也 可 防止 别人 从 已 取得 root 权限 
的 设备 提取 密 钥 ， 以 此 提高 Android N 系统 的 安全 性 。 


1.5 小 结 


本 章 介 绍 了 智能 手机 的 概念 及 其 流行 的 操作 系统 ， 并 对 当前 最 流行 的 Android 操作 系统 进行 
了 详细 介绍 ， 从 其 产生 、 发 展 过 程 中 得 出 其 优势 所 在 。 

本 章 重点 介绍 了 Android 操作 系统 的 系统 构架 ， 从 应 用 程序 层 、 应 用 程序 框架 层 、 核 心 类 库 和 
Linux 内 核 4 部 分 进行 了 详细 的 介绍 ， 并 介绍 了 Android 7.0 的 新 特性 。 
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1. 了 解 Android 系统 的 发 展 过 程 。 
2. Android 系统 架构 分 为 哪 几 层 ? 
3. 系统 库 中 的 核心 库 有 哪些 ? 它们 的 作用 分 别 是 什么 ? 
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2.4 系统 需求 


支持 Android 开发 的 系统 如 下 ， 读 者 可 以 选择 自己 喜欢 的 系统 平台 。 

e Windows XP (32 位 )、Vista (32 位 或 64 位 )、Windows7 (32 位 或 64 位 )、Windows 10 ( 32 
位 或 64 位)。 

* MacOSX10.5.8 或 以 后 版 本 ( x86 )。 

e Linux Ubuntu。 


22 软件 安装 


2.21 JDK 的 安装 


JDK 的 安装 步骤 说 明 如 下 : 

ED) T£ IDK. HT Android 系统 架构 可 以 知道 ， 要 进行 开发 需要 下 载 并 安装 Java 的 开 
发 环境 。 首 先 需要 下 载 免费 JDK KE. Android SDK 需要 IDK 7 以 上 版 本 ，JDK 包含 一 整套 开发 
工具 。 由 于 Sun 公司 已 经 被 Oracle 公司 收购 ， 因 此 需要 到 Oracle 公司 的 网 站 下 载 ， 下 载 地 址 是 : 
http://www.oracle.com/technetwork/java/javase/ downloads/index.html, 值得 注意 的 是 , 必须 下 载 完整 的 
JDK 开发 包 ， 不 可 以 只 安装 JRE 运行 版 本 ， 下 载 界面 如 图 2.1 所 示 。 目 前 最 新 版 本 是 JDK 10， 但 是 
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为 了 更 好 的 稳定 性 ， 建 议 使 用 JDK 8。 





Overview | Downloads Documentation || Community || Technologies Training 


Java SE Downloads 


« 
£ Java < NetBeans 


DOWNLOAD * DOWNLOAD * 


Java Platform (JDK) 9 NetBeans with JDK 8 





Java Platform, Standard Edition 











Java SE 9.0.1 

Java SE 9.0.1 includes important bug fixes. Oracle strongly recommends that all Java SE 9 users 
upgrade to this release. 

Learn more * 


* Installation Instructions JDK 
DOWNLOAD * 
* Release Notes Ea 


* Oracle License 


Server JRE 


* Java SE Licensing Information User Manual 
DOWNLOAD * 


* Third Party Licenses 


* Certified System Configurations JRE 





图 2.1 JavaJDK 下 载 界面 


E 安 装 JDK。 双 击 下 载 的 可 执行 文件 ， 接 受 许可 后 就 可 以 安装 了 。 安 装 过 程 比较 简单 ， 
就 不 再 展开 描述 了 。 

C€X303 配置 Java 环境 变量 。 为 了 使 用 Java 工具 进行 编译 、 运 行 ， 需 要 配置 Java 环境 变量 ， 
采用 相对 路 径 的 方法 , 需要 设置 的 三 个 环境 变量 : JAVA HOME, CLASSPATH 和 PATH. 假设 将 JDK 
安装 到 了 C:JAVANDK8\ 路 径 下 ， 则 右 击 “ 我 的 电脑 。 | “属性 ” | “高 级 ” | “环境 变量 ”。 


e 配置 JAVA HOME: JAVA HOME- “C:JAVAUDK8V. 
e 2% CLASSPATH: CLASSPATH- “: %JAVA_HOME%\jre\lib\t jar.” . 
e 配置 PATH: PATH= “%JAVA_HOME%\bin:”. 


2.2.2 Android Studio 


FR Android 应 用 程序 需要 下 载 相关 的 Android SDK。 到 http://developer.Android.com/ 
sdk/index.html 开发 网 页 ， 如 图 2.2 所 示 ， 根 据 自己 的 操作 系统 下 载 Android SDK 软件 开发 包 。 本 
书 下 载 的 是 Android 7.0 版 本 (APILevel 24) 。 本 书 使 用 官方 推荐 的 Android Studio 进行 开发 ， 版 
本 号 是 2.2.3，Gradle 版 本 是 2.3.3。 
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Download 


Android Studio 


Workflow 


Tools Help 


Build System 


Performance Tools 


Testing Tools 


Support Library 


Data Binding Library 


Revisions 








下 载 完成 后 ， 双 击 即 可 安装 。Android Studio 包含 开发 Android 应 用 所 


及 相关 工具 ， 如 图 2.3 所 示 。 








® HelloAndroid - [E\AndroidStudioprojects\HelloAndroid] - HelloAndroid-HelloAndroid - Android Studio 2.2.3 o x 
File Edit View Navigate Code Analyze Refactor Build Run Tools VCS Window Help 
OWS «^ X 0 AM € > (GHeloAndrid-HeloAndroid -] > 4$ i (à à N A 8 2 & ? Q 
T3 HelloAndroid [jHelloAndroid ‘Ò build gradle 
"DI . 2- 1- | E import-summary.tst X | (B settings gradie x © HelloAndroid-HelloAndroid X lo 
MELILJ i apply plugin: ' com. android. application’ E 
S D gradie = 
~” D idea 
D build android 
e D gradle : " 
$ T's HelloAndroid [HelloAndroi —— 
5 D build buildToolsVersion 
Y 口 src 
D main r 
1 Es defaultConfig { a 
8 E introduction applicationld “introduction. android. hel loAndroid" t" 
由 | minSdkVer 24 
 AndroidManitest| targetSdkVersion 24 
n © build.gradle } e 
3 [à HelloAndroid-HelloAnd 7 
$ © build.gradle | 
El E] gradiew buildTypes [ J 
+ E] gradlew.bat release ( $ 
HelloAndroid iml P B 
is qusseheu m ninifyEnabled false EH 
5 Ji local properties proguardFiles getDefaultProguardFile( proguard-android. txt’), ’ proguards 
Š © settings.gradle 1 f 
We 上 Ifi External Libraries u : 2 
TODO d &AndridMontor  Bllemina| I © Messages Event Lop E] Gradle Console 
Gi Gradie build finished in 3s 1 15ms (3 minutes ago) 12:1 CRLF UTF-8: " a 8 
图 23 Android Studio 运行 界面 
- : » ^ 47 2 a ES u 
Android Studio fl] “Tools” É F&$ —^* “Android” AM, nd 2.4 所 示 ， 单 击 其 中 的 子 


菜单 “SDK Manager” 2/43) SDK 管理 器 。 通过 SDK 管理 


版 本 ， 如 图 2.5 所 示 。 





k como Ox eveloper.android com/inti/z - ^2^a8-|x 
P 
ig Developers > Developer Console Q 





DOWNLOAD ANDROID STUDIO 











Requirements 


图 2.2 Android SDK 下 载 页 





5e 
而 


要 的 文件 、 运 行 环境 

















器 可 以 查看 本 机 已 经 安装 的 Android SDK 
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VCS Window Help 
Tasks & Contexts 

Save File as Template... 
Generate JavaDoc... 
New Scratch File... 

IDE Scripting Console 





"MES 


* | (È HelloAndroid-HelloAndroid x 
CUP Altsstiterinsecty P — — — —— —— — ——34 


id. application" 


© Firebase 


8 sync Project with Gradi Fies 


ff Default Settings 
(a 


* Appearance & Behavior 
Appearance 
Menus and Toolbars 
* System Settings. 
Passwords. 
HTTP Proxy 
Updates 
Usage Statistics 
droid SDK 
Notifications 
Quick Lists 
Path Variables. 
Keymap 
+ Editor 
Plugins 
^ Build, Execution, Deployment 
+ Tools 


"ich “Launch Standalone SDK Manager” 会 启动 独立 的 SDK 管理 器 ， 如 图 2.6 所 示 ， 可 完成 


" iĝ Android Device Monitor 
: E 3 
compileSdkVersion 24 I. AVD Manager 


buildToolsVersion "25 HETTS TRE 
V Enable ADB Integration 


defaultConfig ( Fnit 


applicationId ^in Q Firebase App indexing Test — lo| 





图 2.4 Android 子 菜单 


Appearance & Behavior » System Settings » Android SDK 
Manager for the Android SDK and Tools used by Android Studio 
Android SDK Location: _H:\Android\sdk 


"SDK Platforms | sDK Tools | SDK Update Sites 


Each Android SOK Platform package includes the Android platform and sources 
pertaining to an API level by default. Once installed, Android Studio will 
automatically check for updates. Check "show package details" to display 
individual SOK components. 


Edit 


Name 
C) Android null 
C) Android nuli 

Android 7.1.1 (Nou. 


口 Android 6.0 (Marshmallow) 

D Android 5.1 (Lollipop) 

Android 5.0 (Lollipop) 

DD Android 4.4w (Kitkat Wear) 

D Android 4.4 (KitKat) 

[ Android 4.3 Uelly Bean) 

[ Android 4.2 Uelly Bean) 

[ Android 4.1 Uelly Bean) 

[L Android 4.0.3 (IceCreamSandwich) 
D Android 4.0 (IceCreamSandwich) 
CD Android 3.2 (Honeycomb) 

DD Android 3.1 (Honeycomb) 

D Android 3.0 (Honeycomb) 

[ Android 2.3.3 (Gingerbread) 

DD Android 2.3 Gingerbread) 

[ Android 2.2 (Froyo) 

D Android 2.1 (Eclair) 


Launch Standalone SDK Manager 


BH [ee m] (ee 


图 2.5 SDK Manager 


对 SDK 的 文档 、 工 具 等 进行 相应 的 安装 和 更 新 工作 。 


Status 
Not installed 
Partially installed 
Not installed 


Partially installed 
Partially installed 
Installed 

Not installed 
Not installed 
Not installed 
Not installed 
Not installed 
Not installed 
Not installed 
Not installed 
Not installed 
Not installed. 
Nor installed 
Not installed 
Not installed 
Nor installed 


[ Show Package Details 
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Android SDK Manager 
Packages Tools 
SDK Path: H:\Android\scie 


Packages 
*$ Name API Rev. Status 
[LD Android SDK Build-tools. 24... & Installed 
[L1 Android SDK Build-tools 24 installed 
[TŻ Android SDK Build-tools 22... É Installed 
DE Android 8.0.0 (API 26) 
[1 SDK Platform 26 2 installed 


(IS Android 7.0 (AP1 24) 
[L1 Documentation for Android OK 24 1 È installed 





[19 SOK Platform 24 3 installed 
[FS Android 6.0 (AP1 23) 
[Ë sox Platform 23 3 f'insalled 
(JR Android 5.1.1 (API 22) 
[ë 50x Platform 22 2 installed 
[E Android 5.0.1 (API 21) 
[18 SDK Platform 21 2 installed 
Da ARM EABI v7a System Image 21 4 É installed 
[DT sources for Android SDK 21 1 È installed 
OE extras 
[Ð Google APIs by Google Inc., Andro: O E installed 
[FS Broken Intel x86 Atom google apis 8 installed 
[ 18 Android Support Repository 47 Installed 
Show: L]Updates/New [Installed Select New or Updates 
口 obsolere Deselect All 
Done loading packages. 


图 2.6 独立 的 SDK 管理 器 


2.2.3 创建 AVD 


- n Xx 


Install packages... 


Delete packages. 





O= 


在 Android Studio 中 单 击 Tools|Android| AVD Manager 命令 ， 启 动 Android 虚拟 设备 管理 器 ， 
如 图 2.7 所 示 。 单 击 “Create Virtual Device” 按 钮 ， 出 现 新 建 虚拟 设备 界面 ， 如 图 2.8 所 示 。 总 体 


而 言 ， 界 面 分 为 左 中 右 三 部 分 ， 左 侧 为 TV、Wear、Phone、Tablet 


四 个 类 别 ， 说 明 Android 7 对 电 





视 、 可 穿戴 设备 、 手 机 和 平板 的 开发 都 提供 了 支持 ; 中 间 一 列 为 针对 左 侧 的 某 个 类 别 已 经 建立 好 的 
虚拟 设备 的 配置 文件 , 可 基于 配置 文件 直接 创建 虚拟 设备 ， 右 侧 为 配置 文件 的 图 形 化 描述 , 包括 屏 


幕 尺寸 、 现 实 精细 度 等 。 


f^ Android Virtual Device Manager 


Your Virtual Devices 


Type | Name Resolution API | Target | CPU/ABI Size on Di... 
GE) 4wv. 48x. 21 Andr. arm 650 MB 


[LZ] Apz4  320x. 24 Andr. x86 1GB 


GE) we 320x.. 17 Andr. arm 710MB 


| + Create Virtual Device... | 








Actions 
b^v 
ber 


A Download v 


($8) £2) 





图 2.7 AVD 管理 器 
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Jun, EAE 


© Virtual Device Configuration 





- - - E Nexus 5 
MM x ER 

w Neuss m 4801800 dpi 

Wear || News One ar 00 480,800 hdp 
Ee s MADQS. s60dpi 

Tablet || Nest Mabgs. saodpi 


New Hardware Profile | | Import Hardware Profiles | 


Select Hardware 











1080x19.. — 420dpi 


Nexus 4 ar 768x1280 xhdpi 





2j 


Clone Device... 





Oe Co) 


图 2.8 新 建 虚拟 设备 界面 





要 在 左 侧 单 如 





F Nexus S 配置 文件 创建 虚拟 手机 ， 其 分 辩 率 为 480X800， 现 实效 果 为 hdpi， 需 


fF“Phone”， 在 中 间 选 择 “Nexus S” 配 置 文件 ， 然 后 单 击 “Next” 按 钮 ， 出 现 系统 映 


像 选 择 界面 ， 如 图 2.9 所 示 ， 选 择 系统 映像 文件 ， 决 定 虚拟 手机 的 Android 系统 版 本 、 系 统 架构 以 
及 API 等 级 。Android 7 支持 x86 架构 、x86_64 架构 、armeabi 架构 以 及 arm64 架构 ， 可 根据 需要 
进行 选择 。 选 择 Nougat, API Level 为 24， 架 构 为 x86， 单 击 “Next” 按 钮 ， 进 入 虚拟 设备 参数 配 
置 界面 ， 如 图 2.10 所 示 ， 为 虚拟 手机 设备 起 一 个 名 字 ， 并 可 对 虚拟 设备 的 分 辨 率 、Android 系统 版 
本 、 横 屏 还 是 竖 屏 、3D 绘图 使 用 硬件 加 速 还 是 软件 加 速 等 信息 进行 配置 。 最 后 单 击 “Finish ”按钮 ， 
完成 虚拟 手机 设备 的 创建 。 创 建 的 虚拟 设备 会 出 现在 AVD 管理 器 中 , 单 击 运行 即 可 启动 , 如 图 2.11 


所 示 。 





Select a system image 


Recommended | 26 images | Other images 





AP Level” 








These images. 
fastest and i 





'ended 
ipport for Google APIs 


Questions on API level? 


aeos) NEN (coc 








图 2.9 系统 映像 选择 
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© Virtual Device Configuration 


Android Virtual Device (AVD) 


Android Studio 














Verify Configuration 
AVD Name | My Nexus S API 24 es 
, Default Orientation 
LZ] Nemss 4.0 480x800 hdpi Change... 
LL, Sets the initial orientation of the device. During AVD 
* Nougat Android 7.0 x86 Changes) emulation you can also rotate the device screen. 
Startup orientation 
Landscape 
Emulated On 
Etre Graphics: [Automatic B 


Device Frame EJ Enable Device Frame 


| Show Advanced Settings 








Previous. Next cancel | ET Hr 
图 2.10 虚拟 设备 参数 配置 














图 2.11 新 创建 的 AVD 


2.24 AVD 与 真 机 的 区 别 


AVD 提供 了 近乎 真实 手机 的 虚拟 环境 ， 以 便于 程序 员 进行 调试 。 但 是 AVD 毕竟 不 是 真 机 ， 
有 些 功能 目前 AVD 尚 不 能 模拟 ， 比 如 : 
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AVD 不 支持 真实 的 电话 接听 和 呼叫 ， 但 是 可 以 通过 控制 台 模 拟 电话 呼叫 。 
AVD 不 支持 USB 连接 。 

AND 不 支持 相机 /视频 捕捉 (输入 )。 

AVD 不 支持 耳机 。 

AVD 不 支持 蓝牙 。 

AND 不 能 在 运行 时 确认 SD 卡 的 插入 和 弹出 状态 。 

AVD 不 能 确定 电池 的 电量 多 少 和 充电 状态 。 

AVD 不 能 确定 连接 状态 。 


2.3 Android SDK 介绍 


SDK (Software Development Kit) 软件 开发 工具 包 是 软件 开发 工程 师 用 于 为 特定 的 软件 包 、 软 
件 框 架 、 硬 件 平台 、 操 作 系 统 等 建立 应 用 软件 的 开发 工具 的 集合 。Android SDK 就 是 Android 专属 
的 软件 开发 工具 包 。 


2.3.1 Android SDK 目录 结构 
Android SDK 解压 即 可 完成 安装 ， 其 中 包含 的 文件 、 文 件 夹 如 图 2.12 所 示 。 


Ji add-ons 

J docs 

Jp extras 

d platforms 

di platform-tools 
J samples 


dJ system-images 
而 temp 

J tools 

局 AVD Manager.exe 
局 SDK Manager.exe 
_ SDK Readme.txt 
@ uninstall.exe 








图 2.12 Android SDK 目录 结构 图 


(1) add-ons 

该 目录 中 存放 Android 的 扩展 库 ， 比 如 Google Maps， 但 若 未 选择 安装 Google API， 则 该 目录 
(2) docs 

该 目录 是 developer.Android.com 的 开发 文档 ， 包 含 SDK 平台 、 工 具 、ADT 等 的 介绍 ， 开 发 指 
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南 ，API 文档 ， 相 关 资 源 等 。 
(3) extras 
该 目录 用 于 存放 Android 附加 支持 文件 ， 主 要 包含 Android 的 support 支持 包 、Google 的 几 个 
工具 和 驱动 、Intel 的 IntelHaxm。 
(4) platforms 
该 目录 用 于 存放 Android SDK Platforms 平台 相关 文件 ， 包 括 字 体 、res 资源 、 模 板 等 。 
(5) platform-tools 
该 目录 包含 各 个 平台 工具 ， 其 中 主要 包含 以 下 几 部 分 。 
e api AX. api-versions.xml 文件 ， 用 于 指明 所 需 类 的 属性 、 方 法 、 接 口 等 。 
* lib 目录 。lib 目录 中 只 有 dxjar 文 件 ， 为 平台 工具 启动 dx.bat 时 加 载 并 使 用 jar 包 里 的 类 。 
© aaptexe。 主 要 作用 是 把 开发 的 应 用 打包 成 APK 安装 文件 ， 如 果 用 Eclipse 开发 ， 就 不 用 通过 
命令 窗口 输入 命令 + 参数 实现 打包 。 
* adb.exe。ADB P? Android Debug Bridge 调试 桥 ， 可 以 通过 它 连接 Android 手机 (或 模拟 器 ) 
与 PC 端 ,可 以 在 PC 端 上 控制 手机 的 操作 。 如 果 用 Eclipse 开发 ， 一 般 情 况 下 ADB 会 自动 启 
动 ， 之 后 我 们 可 以 通过 DDMS 来 调试 Android 程序 。 
e aidLexe. AIDL 全 称 是 Android Interface Definition Language, 是 Android 内 部 进程 通信 接口 的 
描述 语言 , 用 于 生成 可 以 在 Android 设备 进行 进程 间 通 信 (Inter-Process Communication, IPC ) 
的 代码 。 
e dexdump.exe。 使 用 dexdump 可 以 反 编 译 .dex 文件 ， 例 如 .dex 文件 里 包含 3 个 类 ， 反 编译 后 也 
会 出 现 3 个 .class 文件 ， 通 过 这 些 文 件 可 以 大 概 了 解 原始 的 Java 代码 。 
* dxbat。 其 功能 是 将 .class 字 节 码 文 件 转 成 Android 字 节 码 .dex X fF. 
e ”fastboot.exe。 通 过 Fastboot 可 以 进行 重启 系统 、 重 写 内 核 、 查 看 连接 设备 、 写 分 区 、 清 空 分 
区 等 操作 。 
* Android llvm-rs-cc.exe。Renderscript 采用 LLVM 低 阶 虚拟 机 ，llvm-rs-cc.exe 的 主要 作用 是 对 
Renderscript 的 处 理 。 
* NOTICE.txt 和 source.properties. NOTICE.txt 只 是 给 出 一 些 提示 的 信息 ; source.properties 是 
资源 属性 信息 文件 ， 主 要 显示 该 资源 生成 时 间 、 系 统 类 型 、 资 源 URL 地 址 等 。 


(6) samples 
samples 是 Android SDK 自 带 的 默认 示例 工程 ， 里 面 的 apidemos 强烈 推荐 初学 者 学 习 。 
(7) system-images 
该 目录 存放 系统 用 到 的 所 有 图 片 。 
(8) temp 
该 目录 存放 系统 中 的 临时 文件 。 
(9) tools 
作为 SDK 根 目录 下 的 tools 文件 夹 ， 这 里 包含 重要 的 工具 ， 比 如 ddms 用 于 启动 Android 调试 
工具 ， 如 logcat、 屏 幕 截图 和 文件 管理 器 ;而 draw9patch 则 是 绘制 Android 平台 的 可 缩放 PNG 图 
片 的 工具 ; sqlite3 可 以 在 PC 上 操作 SQLite 数据 库 ， 而 monkeyrunner 则 是 一 个 不 错 的 压力 测试 应 
用 ， 模 拟 用 户 随机 按钮 ， mksdcard 是 模拟 器 SD 映像 的 创建 工具 ，emulator 是 Android 模拟 器 主 程 
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序 ， 不 过 从 Android 1.5 开始 ， 需 要 输入 合适 的 参数 才能 启动 模拟 器 ; traceview 是 Android 平台 上 
重要 的 调试 工具 。 


2.3.2 Android.jar 


作为 一 个 Java 项 目 ， 通 常情 况 下 都 会 引入 要 用 到 的 工具 类 ， 也 就 是 JAR 包 ， 在 Android 开发 
中 , 绝 大 部 分 开发 用 的 工具 包 都 被 封装 到 一 个 名 叫 Android jar 的 文件 里 了 。 在 Eclipse 中 展开 来 看 ， 
可 以 看 到 J2SE 中 的 包 、Apache 项 目 中 的 包 ， 还 有 Android 自身 的 包 文件 。Android 的 包 文件 主要 
包括 以 下 内 容 。 


Androidapp: 提供 高 层 的 程序 模型 和 基本 的 运行 环境 。 
Android.content: 包含 各 种 对 设备 上 的 数据 进行 访问 和 发 布 的 类 。 
Android.database: 通过 内 容 提 供 者 浏览 和 操作 数据 库 。 
Android.graphics: 底层 的 图 形 库 。 

Android.location: 定位 和 相关 服务 的 类 。 

Android.media; 提供 一 些 类 管理 多 种 音频 、 视 频 的 媒体 接口 。 
Android.net: 提供 帮助 网 络 访问 的 类 ， 超 过 通常 的 java.net.* 接 口 。 
Android.os: 提供 系统 服务 、 消 息 传输 、IPC 机 制 。 

Android.openg : 提供 OpenGL 的 工具 。 

Android provider: 提供 类 ， 访问 Android 的 内 容 提供 者 。 
Android.telephony: 提供 与 拨打 电话 相关 的 API 交互 。 
Android.view: 提供 基础 的 用 户 界面 接口 框架 。 

Android.util: 涉及 工具 性 的 方法 ， 例 如 时 间 日 期 的 操作 。 
Android.webkit: 默认 浏览 器 操作 接口 。 

Android.widget: 包含 各 种 UI 元 素 ( 大 部 分 是 可 见 的 ) 在 应 用 程序 的 屏幕 中 使 用 。 


2.3.3 Android API 核心 包 


SDK 中 集成 了 很 多 开发 应 用 的 API， 它 们 通过 Android SDK 来 编写 应 用 程序 的 基础 ， 这 是 


= 





最 底层 到 最 高 层 列 出 核心 包 并 加 以 说 明 。 


Android util: 包含 一 些 底层 辅助 类 ， 例 如 特定 的 容器 类 、XML 辅助 工具 类 等 。 

Android.os: 提供 基本 的 操作 服务 ， 如 消息 传递 和 进程 间 通信 IPC. 

Android.graphics: 作为 图 形 泻 染 包 ， 提 供 图 形 泻 染 功 能 。 

Android.text Android.text method Android.text.style Android text.util: 提供 一 套 丰 富 的 文本 处 理 
工具 ， 支 持 富 文本 、 输 入 模式 等 。 

Android.database: 包含 底层 API 处 理 数据 库 ， 方 便 操 作 数 据 库 表 和 数据 。 

Android.content: 提供 各 种 服务 访问 手机 设备 上 的 其 他 应 用 的 数据 和 资料 的 接口 。 
Android.view: 核心 用 户 界面 框架 。 

Android.widget: 提供 标准 用 户 界面 元 素 ， 如 List (列表 )、Buttons (按钮 )、Layout manager 
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(布局 管理 器 ) 等 ， 是 组 成 界面 的 基本 元 素 。 
Android.app: 提供 高 层 应 用 程序 模型 ， 实 现 使 用 Activity, 
Android provider: 提供 方便 调用 系统 提供 的 content providers 接口 。 
Android.telephony: 提供 API 和 手机 设备 的 通话 接口 。 
Android.webikit 包含 一 系列 基于 Web 内 容 工 作 的 API。 


2.3.4 Android API 扩展 包 








核心 的 Android API 在 每 部 手机 上 都 可 以 使 用 ,但 仍然 有 一 些 API 接 口 有 各 自 特别 的 适用 范围 ， 
这 就 是 所 谓 的 “可 选 API”。 这 些 API 之 所 以 是 “可 选 的 ”， 主 要 是 因为 一 个 手持 设备 并 不 一 定 要 
完全 支持 这 类 API， 甚 至 可 以 完全 不 支持 。 
© Location-Based Services (定位 服务 )、Android 操作 系统 支持 GPS API-LBS， 可 以 通过 集成 
GPS 芯片 来 接收 卫星 信号 , 通过 GPS 全 球 定位 系统 中 至 少 3 颗 卫星 和 原子 钟 来 获取 当前 手机 
的 坐标 数据 ， 通 过 转换 就 可 以 成 为 地 图 上 的 具体 位 置 ， 这 一 误差 在 手机 上 可 以 缩小 到 10 米 。 
在 谷歌 开发 手机 联盟 中 可 以 看 到 著名 的 SIRF star。 所 以 未 来 gPhone 手机 上 市 时 集成 GPS 后 
的 价格 不 会 很 贵 。 同 时 ， 谷 歌 正 在 研制 基于 基站 式 的 定位 技术 -MYLocation， 可 以 更 快速 地 定 
位 ， 与 前 者 GPS 定位 需要 花费 大 约 1 分 钟 相 比 ， 基 站 定位 更 快 。 
* Media APIs (多 媒体 接口 ) Android 平台 上 集成 了 很 多 影音 解码 器 以 及 相关 的 多 媒体 API， 通 过 
这 些 可 选 API， 厂 商 可 以 让 手机 支持 MP3、MP4、 高 清晰 视频 播放 处 理 等 。 
* 3D Graphics with OpenGL ( 3D 图 形 处 理 OpenGL )， 可 选 API。Android 平台 上 的 游戏 娱乐 功 
能 ， 如 支持 3D 游戏 或 应 用 场景 就 需要 用 到 3D 技术 , 手机 生产 厂商 根据 手机 的 屏幕 以 及 定位 
集成 不 同等 级 的 3D 加 速 图 形 芯片 来 加 强 gPhone 手机 的 娱乐 性 ， 有 来 自 高 通 的 消息 称 ， 最 新 
的 显示 芯片 在 gPhone 上 将 会 轻松 超过 索尼 了 S3。 
* Low-Level Hardware Access (低级 硬件 访问 )。 这 个 功能 主要 用 于 控制 手机 的 底层 方面 操作 ， 
设计 底层 硬件 操作 将 主要 由 各 个 手机 硬件 生产 厂商 来 定制 ， 支 持 不 同 设备 的 操作 管理 ， 如 蓝 
F (Bluetooth) 以 及 WIFI 无 线 网 络 支持 等 。 
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2.4.1 创建 HelloWorld 工程 











启动 Android Studio， 依 次 选择 File | New | New Project， 将 会 出 现 如 图 2.13 所 示 的 界面 。 在 
Application name 中 输入 项 目 名 称 *HelloWorld”, 在 Company Domain 中 输入 “android.introduction ”， 
系统 会 自动 生成 包 名 为 “introduction.Android.helloWorld”，Project Location 指定 工程 文件 存放 的 
位 置 。 单 击 “Next” 按 钮 ， 出 现 如 图 2.14 所 示 的 界面 ， 用 于 选择 应 用 运行 的 系统 版 本 。 选 择 运行 
FAA “Android 7.0”， 再 次 单 击 “Next” 按 钮 ， 进 入 创建 Activity 界面 ， 如 图 2.15 所 示 。 该 界面 
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可 以 添加 多 种 Activity 的 模板 ， 本 次 添加 一 个 基本 的 Activity 即 可 ， 选 择 “Basic Activity”， 单 击 
“Next” 按 钮 ， 进 入 如 图 2.16 所 示 的 界面 ， 指 定 Activity 的 相关 信息 ， 例 如 Activity 的 名 字 、 布 局 
文件 的 名 字 、 菜 单 资 源 的 名 字 以 及 Activity 上 显示 的 标题 。 此 处 使 用 默认 设置 ， 不 做 更 改 。 设 置 完 
成 后 ， 单 击 “Finish” 按 钮 完成 工程 的 创建 。 








Configure your new project 


Application name: | HelloWorld ] 








Prjectlcalon:—[Exxcidstuionrjecisvdi elo res] 














图 2.13 创建 HelloWorld 工程 


KB Target Android Devices 





Select the form factors your app will run on 


Different platforms may require separate SOKS 


E) Phone and Tablet 


Minimum sox [AP124: Android 7.0 (Nougat) iv] 
Lower API levels target more devices, but have fewer features available. 
By targeting API 24 and later, your app will run on approximately 8.1% of the 
devices 





that are active on the Google Play Store. 


口 wesr 

Minimum SOK | API 21: Android 5.0 (Lolipop) MH 
Ow 

Minimum SDK | API 21: Android 5.0 (Lollipop) H 





C Android Auto. 
O Gase 


Minimum sox [Gas Development Kit Preview (9119) B 


E... Ge Ce 





图 2.14 选择 应 用 系统 平台 
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© Create New Project x 
yaa Add an Activity to Mobile 

Add No Activity 

| Falecreen Activity 

ise m B 
Google AdMob Ads Activity Google Maps Activity Login Activity Master/Detail Flow 
— — — — 
[see MUN | cone 








[8215 创建 Activity 


图 Create New Project 


7X Customize the Activity 





Creates a new basic activity with an app bar. 


CRD sue [uS 














Layout Name: activity main 
Title: MainActivity 
Menu Resource Name: | menu main. 
o O thea Fragment 
Basic Activity 


The name of the activity class to create 


| Previous | mex: ca | ET 
图 2.16 185€ Activity 的 相关 信息 


Android Studio 会 根据 刚才 指定 的 相关 信息 生成 相关 模板 代码 ， 用 户 无 须 编写 任何 一 行 代码 ， 
该 工程 就 可 以 运行 。 按 Shift+F10 快捷 键 ， 选 择 要 运行 的 AVD， 可 查看 运行 效果 ， 如 图 2.17 所 示 。 
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Android Emulator - My Nexus S API 2 





í 
HelloWorld bam ToolBar ( i £4) 


图 2.17 运行 效果 (效果 图 颜色 可 在 下 载 资源 中 查看 ) 


2.4.2 ”相关 代码 


双击 HelloWorld 工程 中 的 MainActivity.java， 该 文件 中 己 有 程序 代码 如 下 : 


package introduction.android.helloworld; 


import android.os.Bundle; 

import android. support .design.widget.FloatingActionButton; 
import android. support .design.widget.Snackbar; 

import android.support.v7.app.AppCompatActivity; 

import android.support.v7.widget.Toolbar; 

import android.view.View; 

import android.view.Menu; 

import android.view.MenuItem; 


public class MainActivity extends AppCompatActivity ( 


@Override 

protected void onCreate (Bundle savedInstanceState) { 
super. onCreate (savedInstanceState) ; 
setContentView(R.layout.activity main); 
Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar); 
setSupportActionBar (toolbar); 


FloatingActionButton fab — (FloatingActionButton) findViewById(R.id.fab); 
fab.setOnClickListener(new View.OnClickListener() ( 
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@override 
public void onClick(View view) { 
Snackbar .make (view, "Replace with your own action", Snackbar.LENGTH LONG) 


-setAction("Action", null).show(); 


Ds 


@Override 

public boolean onCreateOptionsMenu(Menu menu) { 
// Inflate the menu; this adds items to the action bar if it is present. 
getMenuInflater().inflate(R.menu.menu main, menu); 
return true; 


@Override 

public boolean onOptionsItemSelected(MenuItem item) { 
// Handle action bar item clicks here. The action bar will 
// automatically handle clicks on the Home/Up button, so long 
// as you specify a parent activity in AndroidManifest.xml. 
int id = item.getItemId(); 


//noinspection SimplifiableIfStatement 
if (id == R.id.action settings) { 
return true; 


return super.onOptionsItemSelected (item); 


) 


MainActivity java 中 的 代码 比较 简单 ， 表 明 类 MainActivity 继承 了 AppCompatActivity 2$, Jf 
EE f onCreate() 方 法 。 

AppCompatActivity 类 是 Android Studio 中 默认 的 构建 自 定义 Activity 的 模板 类 ， 与 
Eclipse+ADT 环境 中 默认 使 用 的 Activity 相 比 ,AppCompatActivity 提供 了 对 工具 栏 ToolBar 的 支持 ， 
相关 代码 如 下 : 

Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar) ; 

setSupportActionBar (toolbar) ; 

在 MainActivity 的 onCreate() 方 法 体 中 调用 了 父 类 的 onCreate() 方 法 , 然后 调用 setContentView() 
方法 显示 视图 界面 。Android 工程 中 使 用 XML 文件 来 设计 视图 界面 ，R.layout.activity_main 是 
Android 工程 中 默认 的 布局 文件 的 名 字 ， 即 activity main.xml. 

Activity_main.xml 的 内 容 如 下 : 

<?xml version-"1.0" encoding-"utf-8"?» 

Xandroid.support.design.widget.CoordinatorLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 


xmlns:app-"http://schemas.android.com/apk/res-auto" 
xmlns:tools-"http://schemas.android.com/tools" 





android:layout width-"match parent" 
android:layout height-"match parent" 
android:fitsSystemWindows-"true" 
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tools:context="introduction.android.helloworld.MainActivity"> 


<android. support .design.widget .FloatingActionButton 
android: id="@+id/fab” 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout gravity-"bottom|end" 
android: layout_margin="@dimen/fab_margin” 
app: srcCompat="@android:drawable/ic dialog email" /> 


<android. support .design.widget .AppBarLayout 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:theme-"8style/AppTheme.AppBarOverlay"» 


<android.support.v7.widget.Toolbar 
d="@+id/toolbar" 

layout width-"match parent" 
android:layout height-"?attr/actionBarSize" 
android:background-"?attr/colorPrimary" 






app:popupTheme="@style/AppTheme.PopupOverlay” /> 
</android.support.design.widget .AppBarLayout> 
<include layout="@layout/content_main" /> 


</android. support .design.widget .CoordinatorLayout> 


CoordinatorLayout 布局 是 support v7 系统 新 增 的 布局 ， 具 有 便于 调度 协调 子 布局 的 特点 。 该 布 
局 可 看 作 是 增强 版 的 FrameLayout， 通 常 与 ToolBar 和 FloatingActionButton 合用 。 

ToolBar 是 图 2.17 中 显示 HelloWorld 的 蓝 色 工具 栏 ， 具 有 承载 系统 菜单 的 功能 。 布 局 相关 代 
码 如 下 : 


<android.support.design.widget.APPBarLayout 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android: theme="@style/AppTheme .AppBarOverlay"» 


<android.support.v7.widget.Toolbar 
android: id="@+id/toolbar" 
android:layout width-"match parent" 
ayout height-"?attr/actionBarSize" 
android:background-"?attr/colorPrimary" 
app :popupTheme="@style/AppTheme.PopupOverlay” /> 
</android.support.design.widget .AppBarLayout> 


FloatingActionButton 是 图 2.17 中 右 下 侧 的 邮箱 图 标的 按钮 ， 布 局 相关 代码 如 下 : 


<android.support.design.widget.FloatingActionButton 
android: id="@+id/fab" 
android: layout_width="wrap_ content" 


android: 








android:layout height-"wrap content" 

android:layout gravity-"bottom|end" 

android:layout margin="@dimen/fab margin" 
app:srcCompat-"Gandroid:drawable/ic dialog email" /> 
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在 MainActivityjava 中 ，FloatingActionButton 的 事件 处 理 代码 为 : 


FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab); 
fab.setOnClickListener (new View.OnClickListener() { 
@override 
public void onClick(View view) { 





Snackbar.make(view, "Replace with your own action", Snackbar.LENGTH LONG) 
-setAction("Action", null).show(); 


n: 
该 代码 实现 的 功能 是 ， 当 点 击 按钮 时 ， 显 示 “Replace with your own action" o 
<include layout="@layout/content main" /> 


这 行 代码 将 content_main.xml 的 布局 嵌入 activity main 布局 中 。content_main.xml 的 代码 为 : 


<?xml version="1.0" encoding="utf-8"?> 

<RelativeLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:app-"http://schemas.android.com/apk/res-auto" 
xmlns:tools-"http://schemas.android.com/tools" 
android: id="@+id/content_main" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:paddingBottom-"Gdimen/activity vertical margin" 
android:paddingLeft-"Gdimen/activity horizontal margin" 
android:paddingRight-"Gdimen/activity horizontal margin" 
android:paddingTop-"Gdimen/activity vertical margin" 
app:layout behavior-"8string/appbar scrolling view behavior" 
tools:context-"introduction.android.helloworld.MainActivity" 
tools:showIn="@layout/activity_main"> 


<TextView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Hello World!" /» 
</RelativeLayout> 


该 文件 中 的 代码 表示 当前 的 布局 文件 使 用 LinearLayout 布局 ， 该 布局 中 仅 有 一 个 TextView 组 


件 用 于 显示 信息 ， 显 示 的 内 容 为 “Hello World! ”。 


Android Studio 鼓励 用 户 将 所 有 组 件 放置 到 content_main.xml 中 ， 而 对 activity main 中 的 代码 


尽量 不 做 修改 。 


为 了 简化 代码 ， 降 低 阅读 难度 ， 在 本 书 的 范例 程序 代码 中 ， 除 非 需要 用 到 工具 栏 和 悬浮 按钮 ， 


都 会 将 .java 文件 和 .xml 文件 中 的 ToolBar 和 FloatingActionButton 的 相关 代码 移 除 掉 ， 并 且 直 接 使 
用 单个 布局 文件 搭建 界面 ， 避 免 使 用 include 将 一 个 布局 嵌入 另 一 个 布局 中 。 


24.33 ”工程 文件 结构 解析 


没有 书写 一 句 程序 代码 , 一 个 Android 应 用 便 创 建成 功 了 , 但 是 这 只 是 一 个 简单 的 Android 应 


用 ， 要 创建 更 多 的 Android 应 用 ， 还 要 详细 地 了 解 Android 应 用 程序 结构 。 


Android Studio 的 Project 工程 文件 结构 如 图 2.18 所 示 。 
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主要 目录 的 作用 如 下 。 

* .gradle 目录 : Gradle 在 构建 工程 的 过 程 中 生成 的 文件 。 

e idea 目录 : Android Studio 生成 的 工程 配置 文件 ， 类 似 Eclipse 的 projectproperties。 

* build 目录: 相当 于 Eclipse 工程 的 bin 目录 ， 用 于 存放 生成 的 文件 ， 包 括 APK. 

* gradle 目录 : 用 于 存放 Gradle 构建 工具 系统 的 JAR 和 Wrapper 等 ， 以 及 配置 文件 。 

© External Libraries: 工程 依赖 的 LIB 文件， 如 SDK 等 。 

e app 目录 : Android Studio 创建 工程 中 的 一 个 Module， 是 程序 开发 者 的 主要 工作 目录 。app B 
录 下 的 结构 如 图 2.19 所 示 。 
+ E HelloWorld &\AndroidStudi 


> D .gradle 
> D idea 
v Dapp » D androidTest 
» O build v O main 
D libs » D java 
> 站 src v Cares 
El .gitignore ©) drawable 
[D app.iml © layout 
(8 build.gradle E menu 
B ‘d-rules.pro I mipmap-hdpi 
proguar: pi : a 
> © build E mipniapandpl 
> E gradle ei 
E .gitignore © mipmap-xxxhdpi 
(È build.gradle [53 values 
[ai gradle.properties © values-v21 
=) gradlew > EJ values-w820dp 
E] gradlew.bat EÈ AndroidManifest.xml 


> 门 test 

B .gitignore 

[3 app.iml 

e build.gradle 

E proguard-rules.pro 


[3 Helloworld.iml 
[ii local.properties 
© settings.gradle 

> Wh External Libraries 








FA 2.18 Android Studio 工程 文件 结构 图 2.19 app 目录 结构 
下 面 分 别 介绍 各 个 目录 或 文件 的 作用 。 


@ sre, 该 目录 (文件 夹 ) 中 包含 应 用 程序 的 所 有 源 代码 。 在 src 文件 夹 中 可 以 创建 若干 Java 包 ， 
在 包 中 可 以 创建 应 用 的 处 理 逻 辑 以 及 应 用 的 Activity，MainActivityjava 就 是 在 创建 项 目的 时 
候 创建 的 一 个 Activity， 在 Activity 中 可 以 编写 控制 View 的 逻辑 . 

* build, ZAR (文件 夹 ) 的 source 包 中 有 一 个 “了 Rjava” 文件 。 及 类 中 包含 4 个 静态 内 部 类 : 
attr, drawable, layout 和 string， 分 别 代表 属性 、 图 片 资源 、 布 局 文件 及 字符 串 的 声明 。Rjava 
文件 是 资源 索引 类 ， 由 Eclipse 自动 生成 ， 开 发 者 不 用 去 修改 和 维护 里 面 的 内 容 ， 但 是 这 个 文 
件 却 非常 有 用 , 它 和 Tes LKR BA, 对 res 下 资源 的 操作 都 会 导致 java 文件 的 重新 编 
译 。 Rjava 中 定义 的 常量 类 也 可 以 间接 帮助 Activity 完成 对 资源 的 应 用 。Android 这 样 设计 的 
好 处 是 使 得 复杂 的 资源 通过 专门 的 类 来 管理 而 让 程序 中 的 代码 变 得 整齐 、 强 壮 ， 并 且 减 少 程 
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序 出 错 和 bug 的 产生 。 

© assets, HAR (文件 夹 ) 中 通常 放置 一 些 原始 资源 文件 ， 它 会 在 Android 打包 的 时 候 原 封 不 
动 地 一 起 打包 ， 安 装 时 会 直接 解压 到 对 应 的 assets 目录 中 。 这 里 通常 放置 一 些 项 目 中 用 到 的 
多 媒体 资源 等 。 

e res, AR (文件 夹 ) 中 放置 的 是 Android 要 用 到 的 各 种 程序 资源 。 其 中 ， 常 见 的 子 文件 来 有 
drawable, layout. values 等 。 其 中 ，drawable 目录 放置 应 用 到 的 图 片 资源 ; layout 目录 放置 
一 些 与 UI 相关 的 布局 文件 ,都 是 以 XML 文件 方式 保存 ; values 目录 中 放置 的 是 一 些 字符 串 、 
数组 、 闫 色 、 样 式 和 动画 等 资源 ，values 目录 中 的 每 一 个 文件 都 会 转化 成 Rjava 中 的 一 个 静 
态 类 ， 文 件 中 的 每 一 个 资源 都 会 转化 成 Rjava 中 对 应 静态 类 的 静态 整 型 常量 ， 这 样 Activity 
中 通过 一 个 解析 器 就 可 以 获取 对 应 的 资源 。 

* AndroidManifestxml。 这 个 文件 是 整个 项 目的 配置 资源 ， 里 面 配置 的 内 容 包括 当前 应 用 程序 
所 在 的 包 、 应 用 程序 中 的 Activity、 应 用 程序 的 访问 权限 等 。 


2.5 调试 程序 


2.5.1 设置 断 点 


设置 断 点 检查 每 个 变量 的 运行 输出 更 适合 一 些 大 型 项 目的 排 错 或 状态 检测 ， 是 Java 开发 中 不 
可 缺少 的 调试 方法 。 
设置 断 点 的 方法 有 两 种 : 


(1) 双击 Android Studio 代码 编辑 区 左边 的 区 域 。 
(2) 在 需要 添加 或 者 移 除 断 点 的 代码 处 接 Ctrl+F8 快捷 键 。 


2.5.2 调试 


通过 单 击 工具 栏 上 的 按钮 , 或 者 在 项 目 上 右 击 , 然后 选择 Debug .…. 菜 单 命令 , 或 者 按 Shift F9 
快捷 键 ， 启 动 程序 的 调试 模式 ， 如 图 2.20 所 示 。 

当 程 序 运行 到 设置 的 断 点 时 就 会 停 下 ， 这 时 可 以 按照 下 面 的 功能 键 按 需 求 进行 调试 : 

o ”快捷 键 F8 单 步 执行 程序 。 

© 快捷 键 F7 单 步 执行 程序 ， 遇 到 方法 时 进入 。 

e 快捷 键 AlttF9 运行 到 光标 处 。 


在 调试 界面 ， 变 量 的 值 会 出 现在 Variables 窗口 中 ， 这 样 就 可 以 查看 运行 至 断 点 时 变量 当前 的 
值 ， 可 在 Watches 界面 添加 想 观测 的 变量 或 者 对 象 的 值 。 
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© HelloWorld - [E:\AndroidS tudioProjects\Android7 \HelloWerld] - [app] - ..\app\sre\nain\jave\introduction\android\helloworld\MainActivity java - Android ... 
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本 章 主要 介绍 了 Android 开发 环境 的 搭建 ， 并 以 HelloWorld 为 例 讲 解 了 Android 工程 的 创建 
过 程 。Android 工程 文件 结构 主要 包括 sre. gen, res, Android 目录 以 及 AndroidManifest.xml 文件 ， 
开发 者 应 该 熟知 每 个 工程 目录 的 作用 。 还 介绍 了 Android Studio 开发 平台 的 基本 调试 方法 ， 希 望 读 
者 在 日 后 的 学 习 中 能 够 熟悉 应 用 程序 的 调试 方法 。 此 外 ， 本 章 还 介绍 了 Android SDK 的 目录 结构 


及 其 核心 包 和 扩展 包 。 


2.7 


习 


1. 尝试 创建 自己 的 第 一 个 Android 工程 。 
2. 请 简要 介绍 Android 工程 中 各 目录 的 作用 。 
3. 谈 谈 你 对 Android SDK 的 认识 。 


Android 应 用 程序 结构 


Android 作为 一 个 移动 设备 的 开发 平台 ， 其 软件 层次 结构 包含 操作 系统 COS) 、 中 间 件 
(MiddleWare) 和 应 用 程序 (Application) 。 其 中 ，Android 的 应 用 程序 通常 涉及 用 户 界面 和 用 户 
交互 ， 这 类 程序 是 用 户 实 实在 在 能 感受 到 的 ， 目 前 Android 本 身 提供 了 桌面 、 联 系 人 、 电 话 和 浏览 
器 等 众多 的 核心 应 用 ， 同 时 还 允许 开发 者 使 用 应 用 程序 框架 层 的 API 实现 自己 的 程序 。 


3.1 应 用 程序 基本 组 成 


Android 系统 没有 使 用 常见 的 应 用 程序 入 口 点 的 方法 (例如 main0 方 法 ) ， 应 用 程序 是 由 组 件 组 成 
的 ， 组 件 可 以 调用 相互 独立 的 基本 功能 模块 ， 根 据 完成 的 功能 不 同 ，Android 划分 了 4 类 核心 组 件 ， 即 
Activity、Service、BroadcastReceiver 和 ContentProvider， 各 组 件 之 间 的 消息 传递 通过 Intent 完成 。 


3.1.1 Activity 


Activity 是 Android 应 用 程序 核心 组 件 中 最 基本 的 一 种 ， 是 用 户 和 应 用 程序 交互 的 窗口 。 在 
Android 应 用 程序 中 ， 一 个 Activity 通常 对 应 一 个 单独 的 视图 。 一 个 Android 应 用 程序 是 由 一 个 或 
多 个 Activity 组 成 的 ， 这些 Activity 相当 于 Web 应 用 程序 中 的 网 页 ， 用 于 显示 信息 ， 并 且 相 互 之 间 
可 以 进行 跳 转 。 和 网 页 跳 转 不 同 的 是 ，Activity 之 间 的 跳 转 可 以 有 返回 值 。 

当 新 打开 一 个 视图 时 ， 之 前 的 那个 视图 会 被 置 为 暂停 状态 ， 并 且 压 入 历史 堆栈 中 ， 用 户 可 以 
通过 回 退 操作 返回 以 前 打开 过 的 视图 。Activity 是 由 Android 系统 进行 维护 的 ， 它 有 自己 的 生命 周 
期 , 即 “ 产 生 、 运行、 销毁 ”, 但 是 在 这 个 过 程 中 会 调用 许多 方法 , 如 创建 onCreate0、 激活 onStart(). 
恢复 onResume()、 暂 停 onPause(). Fit onStop0、 销 毁 onDestroy0 和 重启 onRestart() 等 。 
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3.1.2 Service 


Service 是 一 种 类 似 于 Activity 但 是 没有 视图 的 程序 ， 它 没有 用 户 界 面 ， 可 以 在 后 台 运 行 很 长 
时 间 ， 相 当 于 操作 系统 中 的 一 个 服务 。Android 定义 了 两 种 类 型 的 Service， 即 本 地 Service 和 远程 
Service。 本 地 Service 是 只 能 由 承载 该 Service 的 应 用 程序 访问 的 组 件 ， 而 远程 Service 是 供 在 设备 
上 运行 的 其 他 应 用 程序 远程 访问 的 Service. 

通过 Context.startService(Intent service) 可 以 启动 一 个 Service， 通 过 Context. bindServiceO 可 以 
绑 定 一 个 Service。 





3.1.3 BroadcastReceiver 


BroadcastReceiver 的 意思 是 “广播 接收 者 ”， 顾 名 思 义 ， 它 用 来 接收 来 自 系统 和 其 他 应 用 程序 
的 广播 ， 并 做 出 回应 。 在 Android 系统 中 ， 当 有 特定 事件 发 生 时 就 会 产生 相应 的 广播 。 广播 体现 在 
方方面面 , 例如 ， 当 开机 过 程 完成 后 ， 系 统 会 产生 一 条 广播 ， 接 收 到 这 条 广播 就 能 实现 开机 启动 服 
务 的 功能 ， 当 网 络 状态 改变 时 ， 系 统 会 产生 一 条 广播 ， 接收 到 这 条 广播 就 能 及 时 地 做 出 提示 和 保存 
数据 等 操作 ; 当 电池 电量 改变 时 ， 系 统 会 产生 一 条 广播 ， 接 收 到 这 条 广播 就 能 在 电量 低 时 告知 用 户 
及 时 保存 进度 等 。 

BroadcastReceiver 不 能 生成 UI， 通 过 NotificationManager 来 通知 用 户 有 事件 发 生 ， 对 于 用 户 
来 说 是 隐 式 的 。BroadcastReceiver 的 注册 方式 有 两 种 ， 一 种 是 在 AndroidManifest. xml 中 进行 静态 
注册 ; 另 一 种 是 在 运行 时 的 代码 中 使 用 Context.registerReceiver0 进 行动 态 注册 。 只 要 注册 了 
BroadcastReceiver， 即 使 对 应 的 事件 广播 来 临时 应 用 程序 并 未 启动 ， 系 统 也 会 自动 启动 该 应 用 程序 
对 事件 进行 处 理 。 另 外 , 用户 还 可 以 通过 Context.sendBroadcast0 将 自己 的 Intent 对 象 广播 给 其 他 的 
应 用 程序 。 








3.1.4 ContentProvider 


文件 、 数 据 库 等 数据 在 Android 系统 内 是 私有 的 , 仅 允 许 被 特定 应 用 程序 直接 使 用 。 在 两 个 程 
序 之 间 ， 数 据 的 交换 或 共享 由 ContentProvider 实现 。 

ContentProvider 类 实现 了 一 组 标准 方法 的 接口 ， 从 而 能 够 让 其 他 的 应 用 保存 或 读 取 
ContentProvider 提供 的 各 种 数据 类 型 。 


3.1.5 Intent 


Intent 并 不 是 Android 应 用 程序 四 大 核心 组 件 之 一 ， 但 是 其 重要 性 无 可 替代 ， 因 此 在 这 里 我 们 
做 一 下 简单 介绍 。 

Android 应 用 程序 核心 组 件 中 的 三 大 核心 组 件 Activity、Service、BroadcastReceiver， 通 过 
消息 机 制 被 启动 激活 ， 而 所 使 用 的 消息 就 是 Intente Intent 是 对 即将 要 进行 的 操作 的 抽象 描述 ， 承 
担 了 Android 应 用 程序 三 大 核心 组 件 相互 之 间 的 通信 功能 。 








第 3 章 Android 应 用 程序 结构 | 35 





3.2 Activity 


Activity 是 Android 组 件 中 最 基本 也 是 最 为 常见 的 组 件 。Activity 是 用 户 接口 程序 ， 原 则 上 它 
会 提供 给 用 户 一 个 交互 式 的 接口 功能 ， 几 乎 所 有 的 Activity 都 要 和 用 户 打 交道 , 也 有 人 把 它 比喻 成 
Android 的 管理 员 。 需 要 在 屏幕 上 显示 什么 、 用 户 在 屏幕 上 做 什么 、 处 理 用 户 的 不 同 操作 等 都 由 
Activity 来 管理 和 调度 。 

Activity 提供 用 户 与 Android 系统 交互 的 接口 ， 用 户 通 过 Activity 来 完成 自己 的 目的 ， 例 如 打 
电话 、 拍 照 、 发 送 E-mail、 查 看 地 图 等 。 每 个 Activity 都 提供 一 个 用 户 界面 窗口 ， 一 般 情况 下 ， 该 
界面 窗口 会 填 满 整 个 屏幕 ， 但 是 也 可 以 比 屏幕 小 ， 或 者 浮 在 其 他 的 窗口 之 上 。 

一 个 Android 应 用 程序 通常 由 多 个 Activity 组 成 ， 但 是 其 中 只 有 一 个 为 主 Activity， 其 作用 相 
当 于 Java 应 用 程序 中 的 main 函数 ， 当 应 用 程序 启动 时 ， 作 为 应 用 程序 的 入 口 首 先 呈现 给 用 户 。 
Android 应 用 程序 中 的 多 个 Activity 可 以 直接 相互 调用 以 完成 不 同 工 作 。 当 新 的 Activity 被 启动 的 
时 候 ， 之 前 的 Activity 会 停止 ， 但 是 不 会 被 销毁 ， 而 是 被 压 入 “后 退 栈 (Back Stack) ”的 栈 顶 ， 
新 启动 的 Activity 获得 焦点 , 显示 给 用 户 。“ 后 退 栈 ” 遵 循 “后 入 先 出 ”的 原则 。 当 新 启动 的 Activity 
被 使 用 完毕 ， 用 户 单 击 “Back” 按 钮 时 ， 当 前 的 Activity 会 被 销毁 ， 而 原先 的 Activity 会 被 从 “后 
退 栈 ” 的 栈 项 弹出 并 且 激 活 。 

当 Activity 状态 发 生 改变 时 ， 都 会 通过 状态 回调 函数 通知 Android 系统 。 而 程序 编写 人 员 可 以 
通过 这 些 回调 函数 对 Activity 进行 进一步 的 控制 。 

下 面 对 Activity 生命 周期 及 其 涉及 的 回调 函数 进行 简单 介绍 。 























3.2.1 Activity 的 生命 周期 


从 本 质 上 讲 ，Activity 在 生命 周期 中 共存 在 三 个 状态 ， 分 别 如 下 。 

© 运行 态 : 运行 态 指 Activity 运行 于 屏幕 的 最 上 层 并 且 获得 了 用 户 焦点 。 

o 暂停 态 : 暂停 态 是 指 当 前 Activity 依然 存在 ， 但 是 没有 获得 用 户 焦点 。 在 其 之 上 有 其 他 的 Activity 
处 于 运行 态 ， 但 是 由 于 处 于 运行 态 的 Activity 没有 遮挡 住 整个 屏幕 ， 当 前 Activity 有 一 部 分 视图 
可 以 被 用 户 看 见 。 处 于 暂停 态 的 Activity 保留 了 自己 所 使 用 的 内 存 和 用 户 信息 ， 但 是 在 系统 极度 
缺乏 资源 的 情况 下 ， 有 可 能 会 被 杀 死 以 释放 资源 。 

e 停止 态 : 停止 态 是 指 当前 Activity 完全 被 处 于 运行 态 的 Activity 遮挡 住 ， 其 用 户 界 面 完 全 不 能 
被 用 户 看 见 。 处 于 停止 态 的 Activity 依然 存活 ， 也 保留 了 自己 所 使 用 的 内 存 和 用 户 信息 ， 但 
是 一 旦 系统 缺乏 资源 ， 停 止 态 的 Activity 就 会 被 杀 死 以 释放 资源 。 

Activity 在 生命 周期 中 从 一 种 状态 到 另 一 种 状态 时 会 激发 相应 的 回调 方法 ， 这 些 回调 方法 包括 : 

© onCreate (Bundle savedInstanceState )。 创 建 Activity 时 调用 。 设 置 在 该 方法 中 ， 还 以 Bundle 
的 形式 提供 对 以 前 储存 的 任何 状态 的 访问 。 其 中 参数 savedInstanceState 对 象 是 用 于 保存 
Activity 的 对 象 的 状态 。 

© onStar(). Activity 变 为 在 屏幕 上 对 用 户 可 见 时 调用 。 

* onResume(), Activity 开始 与 用 户 交互 时 调用 (无论 是 启动 还 是 重启 一 个 活动 ， 该 方法 总 是 被 调用 )。 
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© onPause0。 当 Android 系统 要 激活 其 他 Activity 时 ， 该 方法 被 调用 ， 暂 停 或 收回 CPU 和 其 他 
资源 时 调用 。 

© onStop(). Activity 被 停止 并 转 为 不 可 见 阶 段 时 调用 。 

* ”onRestart()。 重 新 启动 已 经 停止 的 Activity 时 调用 。 

© onDestroy(). Activity 被 完全 从 系统 内 存 中 移 除 时 调用 ， 该 方法 被 调用 可 能 是 因为 有 人 直接 调 
用 finish0 方 法 或 者 系统 决定 停止 该 活动 以 释放 资源 。 

上 面 7 个 生命 周期 方法 分 别 在 4 个 阶段 按 着 一 定 的 顺序 进行 调用 ， 这 4 个 阶段 如 下 : 

© 启动 Activity。 在 这 个 阶段 依次 执行 3 个 生命 周期 方法 : onCreate、onStart 和 onResume, 


© Activity 失去 焦点 。 如 果 在 Activity 获得 焦点 的 情况 下 进入 其 他 的 Activity 或 应 用 程序 ， 这 时 当前 
的 Activity 会 失去 焦点 。 在 这 一 阶段 ， 会 依次 执行 onPause 和 onStop 方法 。 

© Activity 重 获 焦点 。 如 果 Activity 重新 获得 焦点 ， 会 依次 执行 3 个 生命 周期 方法 : onRestart、 
onStart 和 onResume。 


e 关闭 Activity。 当 Activity 被 关闭 时 ， 系 统 会 依次 执行 3 个 生命 周期 方法 : onPause、onStop 
和 onDestroy. 


Activity 生命 周期 中 方法 的 调用 过 程 如 图 3.1 所 示 。 






E a 
Say i 





The acti 


us 





‘Another activity comes 
in front of the activity 








图 3.1 Activity 生命 周期 


5832 Android 应 用 程序 结构 | 37 





通过 图 3.1, 可 以 很 直观 地 了 解 到 Activity 的 整个 生命 周期 。Activity 的 生命 周期 表现 在 三 个 层 
面 ， 如 图 3.2 所 示 。 
Activity 的 整个 生命 周期 
onCreate() 整个 生命 周期 








onRestart() 可 见 阶段 





前 台阶 段 
onStart() 


onResume() 


onPause() 


onStop() dp 




















onDestroy() 





FA 3.2 Activity 的 整个 生命 周期 


通过 图 3.2 可 以 更 清楚 地 了 解 Activity 的 运行 机 制 。 如 果 Activity 离开 可 见 阶段 ， 长 时 间 失 去 
焦点 ， 就 很 可 能 被 系统 销毁 以 释放 资源 。 当 然 ， 即 使 该 Activity 被 销毁 掉 ， 用 户 对 该 Activity 所 做 
的 更 改 也 会 被 保存 在 Bundle 对 象 中 ， 当 用 户 需要 重新 显示 该 Activity 时 ，Android 系统 会 根据 之 前 
保存 的 用 户 更 改 信息 将 该 Activity 重建 。 


3.2.2 Activity 的 创建 


在 一 个 Android 工程 中 ， 创 建 Activity 的 步骤 如 下 : 

ED) 新 建 类 。 创 建 一 个 Activity， 必 须 创 建 Android.app.Activity (或 者 它 的 一 个 已 经 存在 
的 子 类 ) 的 一 个 子 类 ， 并 重 写 onCreate0 方 法 。 

ED 关联 布局 XML 文件 。 在 新 建 的 Activity 中 设置 其 布局 方式 , 需要 在 res/layout 目录 中 
新 建 一 个 XML 布局 文件 ， 可 以 通过 setContentView0 来 指定 Activity 的 用 户 界 面 的 布局 文件 。 

€I 注册 。 在 AndroidManifest.xml 文件 中 对 建立 的 Activity 进行 注册 ， 即 在 <application> 
标签 下 添加 <activity> 标 签 。 例 如 ， 注 册 ExampleActivity 的 代码 如 下 : 


<application ...> 
<activity Android:name-".ExampleActivity" /> 


</application ...> 
对 于 主 Activity， 要 为 其 添加 <intent-filter> 标 签 ， 代 码 如 下 : 
«activity Android:name-".ExampleActivity" Android: icon="@drawable/app_icon"> 


<intent-filter> 
<action Android:name-"Android.intent.action.MAIN" /> 
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«category Android:name-"Android.intent.category.LAUNCHER" /> 
«/intent-filter» 
</activity> 
其 中 ，<action Android:name="Android.intent.action. MAIN" /> 表示 该 Activity 作为 主 Activity 出 
现 ， 而 <category Android:name="Android intent.category. LAUNCHER" /> 表示 该 Activity 会 被 显示 在 
最 上 层 的 启动 列表 中 。 


3.2.3 ”启动 Activity 


在 Android 系统 中 ， 除 了 主 Activity 由 系统 启动 外 ， 其 他 Activity 都 要 由 应 用 程序 来 启动 。 
(1) 通 常情 况 下 , 通过 startActivity0 方 法 来 启动 Activity, 而 要 启动 的 Activity 的 信息 由 Intent 
对 象 来 传递 ， 例 如 : 


Intent intent=new Intent (this, AnotherActivity.class) ; 
startActivity (intent) ; 


表示 通过 当前 的 Activity 启动 名 为 AnotherActivity 的 Activity. 
有 时 ， 用 户 不 需要 知道 要 启动 的 Activity 的 名 字 ， 而 可 以 仅 制定 要 完成 的 行为 ， 由 Android 系 
统 来 为 用 户 挑选 合适 的 Activity， 例 如 : 


Intent intent=new Intent (Intent.ACTION_SEND) ; 
intent.putExtra (Intent.EXTRA_EMAIL, recipientArray) ; 
startActivity (intent) ; 


HP, Intent EXTRA_EMAIL 放置 的 是 recipientArray 中 存储 的 要 发 送 的 E-mail 的 目标 地 址 。 
该 Intent 对 象 被 startActivity0 启 动 后 ，Android 系统 会 启动 相应 的 E-mail 处 理应 用 程序 ， 并 将 
Intent. EXTRA. EMAIL 中 的 内 容 放置 到 邮件 的 目标 地 址 中 。 

(2) 有 时 ， 当 需要 从 启动 的 Activity 获取 返回 值 的 时 候 ， 需 要 使 用 startActivityForResult() 77 

法 代替 startActivity0 方 法 ， 并 实现 onActivityResult() 方 法 来 获取 返回 值 。 

例如 ， 在 发 送 短信 的 时 候 ， 用 户 需要 从 联系 人 列表 中 获取 联系 人 的 信息 ， 然 后 返回 到 短信 发 
送 界面 ， 代 码 如 下 : 

Intent intent=new Intent (Intent.ACTION PICK, Contacts.CONTENT URI) ; 

startActivityForResult (intent, PICK CONTACT REQUEST) ; 


当 用 户 选择 了 联系 人 后 ， 相 关 信 息 会 被 存储 到 Intent 对 象 中 ， 并 返回 到 onActivityResult0 方 法 中 。 





3.2.4 关闭 Activity 


关闭 Activity 使 用 finish0 方 法 。 关 闭 之 前 启动 的 其 他 Activity 可 以 使 用 finishActivity0 方 法 。 

需要 注意 的 是 , 虽然 Android SDK 提供 了 关闭 Activity 的 方法 , 但 是 通常 情况 下 , 程序 员 不 应 
该 使 用 这 些 方法 去 强制 关闭 Activity。 因 为 Android 系统 在 为 用 户 维护 Activity 的 生命 周期 ， 并 且 
提供 了 完备 的 资源 回收 机 制 和 资源 重建 机 制 ， 可 以 动态 地 回收 和 重建 Activity， 因 此 Activity 应 用 
交 由 Android 系统 来 管理 ， 除 非 已 确定 用 户 不 再 需要 当前 的 Activity， 并 且 不 允许 用 户 回 退 到 当前 
Activity。 
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3.2.5 Activity 数据 传递 


Activity 数据 传递 共有 三 种 : 


e 通过 Intent 传递 一 些 简单 的 数据 。 
e iit Bundle 传递 相对 复杂 的 数据 或 者 对 象 。 
e 通过 startActivityForResult 可 以 更 方便 地 进行 来 回 传递 ， 当 然 前 两 种 方法 也 可 以 来 回 传递 。 


假设 由 Activity] 向 Activity2 传递 数据 ， 利 用 三 种 方式 实现 的 实例 代码 如 下 。 
CD 利用 Intent 传递 数据 。 

在 传递 数据 的 Activity] 中 : 

Intent intent=new Intent (Activityl.this,Activity2.class) ; 


intent.putExtra ("author","leebo") ;//# Intent 中 加 入 键 值 对 数据 ， 键 为 “author”， 值 为 “leebo” 
Activityl.this.startActivity (intent) ; 


在 取出 数据 的 Activity2 中 : 


Intent intent-getIntent () ;// 获 得 传 过 来 的 Intent 
String value-intent.getStringExtra ("author") ; 


// 根 据 键 名 author 取出 对 应 键 值 为 “leebo” 
(2) 利用 Bundle 传递 数据 。 
在 传递 数据 的 Activityl 中 ， 
Intent intent=new Intent (Activityl.this,Activity2.class) ; 
Bundle myBundle=new Bundle (); 
myBundle.putString ("author", "leebo") ; 


intent.putExtras (myBundle) ; 
Activityl.this.startActivity (intent) ; 


在 取出 数据 的 Activity2 中 : 


Intent intent=getIntent (); 
Bundle myBundle=intent.getExtras (); 
String value-myBundle.getString ("author") ; // 根 据 键 名 author 取出 对 应 键 值 为 “leebo” 


(3) 利用 startActivityForResultO 传 递 数据 。 

startActivityForResult0) 方 法 不 但 可 以 把 数据 从 Activity] 传递 给 Activity2， 还 可 以 把 数据 从 
Activity2 传 回 给 Activity] 。 

在 Activityl 中 : 

final int REQUEST_CODE=1; 

Intent intent-new Intent (Activityl.this,Activity2.class) ; 

Bundle mybundle-new Bundle(); 

mybundle.putString ("author", "leebo") ;// 把 数据 传 过 去 


intent.putExtras (mybundle) ; 
startActivityForResult (intent, REQUEST CODE) ; 


重 载 onActivityResult 方法 ， 用 来 接收 传 过 来 的 数据 〈 接 收 b 中 传 过 来 的 数据 ) : 


protected void onActivityResult (int requestCode, int resultCode,Intent intent) { 
if (requestCode--this.REQUEST CODE) { 
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switch (resultCode) { 
case RESULT_OK: 
Bundle b-intent.getExtras(); 
String str-b.getString ("Result") ; // 获 取 Result 中 的 值 , Jy “from Activity2" 
break; 
default: 
break; 
} 
} 
) 


在 Activity2 P: 


Intent intent=getIntent (); 

Bundle myBundle=getIntent () .getExtras () 7 

String author-getBundle.getString ("author") ; 

Intent intent-new Intent (); 

Bundle bundle-new Bundle(); 

bundle.putString ("Result","from Activity2") ; 

intent.putExtras (bundle) ; 

Activity02.this.setResult (RESULT OK,intent) ;// 通 过 intent 将 数据 返回 给 Activityl, RESULT_ OK 


RARD: 
finish () ;// 结 束 当前 的 Activity 


本 质 上 ， 这 三 种 数据 传递 方式 都 是 通过 Intent 来 完成 的 。 
33 资 M 


在 Android 层次 结构 中 ， 资 源 扮演 着 重要 的 角色 。Android 支持 字符 串 、 位 图 以 及 其 他 很 多 种 
类 型 的 资源 。 每 一 种 资源 的 语法 、 格 式 以 及 存放 的 位 置 都 会 根据 其 类 型 的 不 同 而 不 同 。 一 般 来 讲 ， 
共有 三 种 类 型 的 资源 文件 : XML 文件 、 位 图 文件 〈 图 像 ) 和 了 RAW 文件 〈 声 音 等 ) 。 

Android 工程 目录 中 ， 用 于 存放 资源 文件 的 文件 夹 有 两 个 ， 分 别 为 res 和 assets。 其 中 ，res X 
件 夹 不 支持 深度 子 目录 ， 其 中 的 资源 最 终 将 被 打包 到 编译 后 的 Java 文件 中 ， 可 以 直接 通过 R 资源 
类 访问 , 利用 率 较 高 ， 而 assets 中 存放 的 资源 是 用 于 打包 到 应 用 程序 中 的 静态 文件 ， 这 些 文件 不 会 
被 编译 ， 最 终 会 直接 部 署 到 目标 设备 中 ， 可 以 使 用 任意 深度 的 子 目录 进行 存储 。assets 文件 夹 中 的 
文件 不 能 直接 通过 R 资源 类 读 取 ， 只 能 使 用 流 的 形式 读 取 ， 其 利用 率 相对 较 低 。 

Android 的 资源 编译 器 AAPT (Android Asset Packaging Tool) 会 依照 资源 所 在 的 子 目 录 及 其 
格式 对 其 进行 编译 。 


34 Manifest 文件 


每 一 个 Android 项 目 都 包含 一 个 清单 (Manifest) 文件 AndroidManifestxml， 它 是 XML 格式 
的 Android 程序 声明 文件 ， 包 含 Android 系统 运行 程序 前 所 必须 掌握 的 重要 信息 ， 这 些 信息 包含 应 
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用 程序 名 称 、 图 标 、 包 名 称 、 模 块 组 成 、 授 权 和 SDK 最 低 版 本 等 ， 而 且 每 个 Android 程序 必须 在 
根 目录 下 包含 一 个 AndroidManifestxml。 
例如 ，Manifest 文件 可 以 使 用 如 下 代码 声明 一 个 Activity: 


AndroidManifestxml 中 可 包含 的 所 有 标签 元 素 如 以 下 代码 所 示 ， 其 中 除了 <manifest> 和 
<application> 标 签 是 必需 的 ， 其 他 所 有 标签 都 可 按 情 况 添 加 。 
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</provider> 
«uses-library /> 
</application> 
</manifest> 
在 此 ， 仅 对 几 种 常见 的 标签 进行 简单 介绍 。 
(1) manifest 标签 
manifest 标签 是 AndroidManifest xml 文件 的 根 标签 ， 该 标签 用 于 设置 与 项 目 相 关 的 一 些 属性 ， 
比如 用 于 唯一 标识 应 用 程序 的 package 属性 , 用 于 记录 应 用 程序 版 本 的 Android:versionName 属性 ， 
等 等 。 其 中 的 xmlns:Android 属性 必须 被 定义 为 “http://schemas. Android.com/apk/res/Android" . 
(2) application 标签 
manifest 标签 仅 能 包含 一 个 application 标签 , 它 使 用 各 种 属性 来 指定 应 用 程序 的 各 种 元 数据 ( 包 
括 标题 、 图 标 和 主题 ) 。 它 还 可 以 作为 一 个 包含 活动 (Activity) 、 服 务 (Service) 、 内 容 提供 器 
(Provider) 和 广播 接收 器 (Broadcast Receiver) 标签 的 容器 ， 用 来 指定 应 用 程序 组 件 。 
© activity 标签 .应 用 程序 显示 的 每 一 个 Activity 都 要 求 有 一 个 activity 标签 ,并 使 用 Android:name 
属性 来 指定 类 的 名 称 。 这 必须 包含 核心 的 启动 Activity 和 其 他 所 有 可 以 显示 的 屏幕 或 者 对 话 
框 。 启 动 任何 一 个 没有 在 清单 中 定义 的 Activity 时 都 会 抛 出 一 个 运行 时 异常 。 每 一 个 Activity 
节点 都 允许 使 用 intent-filter 子 标签 来 指定 哪个 Intent 启动 该 活动 。 
e service 标签 。 和 activity 标签 一 样 ， 应 用 程序 中 使 用 的 每 一 个 Service 类 都 要 创建 一 个 新 的 
service 标签 。( Service 标签 也 支持 使 用 intent-filter 子 标签 来 允许 后 面 的 运行 时 绑 定 。) 
* provider 标签 。provider 标签 用 来 说 明 应 用 程序 中 的 每 一 个 内 容 提 供 器 。 内 容 提 供 器 是 用 来 管 
理 数 据 库 访问 以 及 程序 内 和 程序 间 共 享 的 。 
© receiver 标签 。 通过 添加 receiver 标签 , 可 以 注册 一 个 广播 接收 器 , 而 不 用 事先 启动 应 用 程序 。 
广播 接收 器 就 像 全 局 事件 监听 器 一 样 , 一 旦 注册 了 之 后 , 无 论 何 时 ,只 要 与 它 相 匹配 的 Intent 
被 应 用 程序 广播 出 来 ， 它 就 会 立即 执行 。 通 过 在 声明 中 注册 一 个 广播 接收 器 ， 可 以 使 这 个 进 
程 实现 完全 自动 化 。 如 果 一 个 匹配 的 Intent 被 广播 了 ， 应 用 程序 就 会 自动 启动 ， 并 且 你 注册 
的 广播 接收 器 也 会 开始 运行 。 








(3) uses-permission 标签 

作为 安全 模型 的 一 部 分 ，uses-permission 标签 声明 了 那些 自己 定义 的 权限 ， 而 这 些 权限 是 应 用 
程序 正常 执行 所 必需 的 。 在 安装 程序 时 ， 设 定 的 所 有 权限 将 会 告诉 用 户 ， 由 他 们 来 决定 同意 与 否 。 
对 很 多 本 地 Android 服务 来 说 ， 权 限 都 是 必需 的 ， 特 别 是 那些 需要 付费 或 者 有 安全 问题 的 服务 〈 例 
如 拨号 、 接 收 SMS 或 者 使 用 基于 位 置 的 服务 ) 。 第 三 方 应 用 程序 ， 包 括 你 自己 的 应 用 程序 ， 也 可 
以 在 提供 对 共享 的 程序 组 件 进行 访问 之 前 指定 权限 。 

(4) permission 标签 

在 可 以 限制 访问 某 个 应 用 程序 组 件 之 前 ， 需 要 在 清单 中 定义 一 个 pemmission。 可 以 使 用 
permission 标签 来 创建 这 些 权限 定义 。 然 后 ， 应 用 程序 组 件 就 可 以 通过 添加 Android: permission 属 
性 来 要 求 这 些 权 限 。 其 他 的 应 用 程序 需要 在 它们 的 清单 中 包含 uses-permission 标签 〈 并 且 通 过 授 
BO ， 之 后 才能 使 用 这 些 受 保护 的 组 件 。 在 permission 标签 内 ， 可 以 详细 指定 允许 的 访问 权限 的 级 
别 (normal. dangerous. signature 和 signatureOrSystem) 、 一 个 label 属性 和 一 个 外 部 资源 ， 这 个 
外 部 资源 应 该 包含 对 授予 这 种 权限 的 风险 的 描述 。 
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(5) instrumentation 标签 
instrumentation 类 提供 一 个 框架 ， 用 来 在 应 用 程序 运行 时 在 活动 或 者 服务 上 运行 测试 。 它 们 提 
供 了 一 些 方法 来 监控 应 用 程序 及 其 与 系统 资源 的 交互 .对 于 为 自己 的 应 用 程序 所 创建 的 每 一 个 测试 
类 ， 都 需要 创建 一 个 新 的 节点 。 


3.5 App Widgets 


App Widgets 是 指 能 够 杠 入 其 他 应 用 程序 中 的 小 组 件 ， 并 且 能 够 周期 性 地 进行 更 新 。App 
Widgets 并 不 是 Android 应 用 程序 的 核心 组 件 ， 但 却 是 应 用 程序 开发 不 可 或 缺 的 部 分 。 我 们 可 以 通 
过 App Widgets 使 我 们 的 UI 界面 更 多 样 化 ， 也 可 以 通过 App Widget Provider 发 布 我 们 自己 开发 的 
App Widgets 组 件 。 一 个 能 够 用 于 容纳 App Widgets 组 件 的 应 用 程序 组 件 被 称 为 App Widgets Host 

(CApp Widgets 宿主 ) ， 例 如 图 3.3 所 示 的 音乐 播放 程序 。 


A Lorke Des Bois T >>I 


Plants And Animals 





图 3.3 App Widgets Host 


Android 7.0 中 涉及 部 分 App Widgets 类 的 使 用 方法 会 在 第 4 章 进 行 详细 介绍 ,本 节 主 要 对 使 用 
App Widget Provider 发 布 自己 的 App Widget 组 件 的 方法 进行 简单 介绍 。 


3.5.1 基础 知识 


为 了 创建 一 个 自己 的 App Widget， 需 要 完成 以 下 工作 。 
1. AppWidgetProviderlnfo 元 数据 


定义 在 XML 文件 中 的 用 于 描述 App Widget 的 元 数据 对 象 ， 比 如 App Widget 的 布局 、 更 新 频 
率 以 及 相关 的 AppWidgetProvider 类 。 

2. 实现 AppWidgetProvider 类 

在 AppWidgetProvider 类 中 定义 了 一 系列 方法 ， 这 些 方法 允许 开发 者 以 编程 的 方式 和 自己 的 
App Widget 进行 交互 ， 这 种 交互 基于 广播 事件 。 当 App Widget 的 状态 发 生 改变 ， 例 如 更 新 、 启 用 、 
禁用 和 删除 的 时 候 ， 你 都 会 接收 到 相应 的 广播 通知 。 

3. 视图 布局 

在 XML 文件 中 为 App Widget 定义 初始 布局 。 

4. 实现 App Widget 配置 Activity 

这 是 一 个 可 选 的 Activity， 当 用 户 添加 App Widget 时 该 Activity 会 被 启动 ， 并 人 允许 用 户 在 创建 
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App Widget 时 修改 相关 设置 。 
下 面 进 行 详 细 介绍 。 


3.5.2 在 Manifest 文件 中 声明 App Widget 


首先 ， 在 AndroidManifestxml 文件 中 对 AppWidgetProvider 类 进行 声明 。 相 关 代码 如 下 : 
«receiver android:name-"ExampleAppWidgetProvider" > 
<intent-filter> 
<action android:name="android.appwidget.action.APPWIDGET UPDATE" /> 
</intent-filter> 
<meta-data android:name-"android.appwidget.provider" 
android: resource="@xml/example appwidget info" /> 
</receiver> 
<receiver> 元 素 必 须要 指定 androidname 属性 ， 它 指定 了 App Widget 使 用 的 
AppWidgetProvider 的 名 字 。 
<intent-filter> 元 素 必 须 包 括 一 个 含有 android:name 属性 的 <action> 元 素 。 该 元 素 指 定 
AppWidgetProvider 接受 ACTION APPWIDGET UPDATE 广播 。 这 是 唯一 一 个 必须 被 显 式 声明 的 
广播 。 当 有 必要 的 时 候 ，AppWidgetManager 会 自动 发 送 所 有 其 他 App Widget 广播 给 
AppWidgetProvider. 
<meta-data> 元 素 指定 了 AppWidgetProviderInfo 资源 并 需要 以 下 属性 。 
* android:name: 指定 元 数据 名 称 。 
* android:resource: 指定 AppWidgetProviderInfo 资源 路 径 。 


3.5.3” 增 加 AppWidgetProviderlnfo 元 数据 


AppWidgetProviderInfo 用 于 定义 App Widget 的 一 系列 基本 特性 ， 例 如 最 小 布局 的 尺寸 、 初 始 
的 布局 资源 、 刷 新 频率 以 及 创建 时 要 加 载 的 配置 Activity 等 。 使 用 <appwidget-provider> 元 素 标签 在 
XML 中 定义 AppWidgetProviderInfo 对 象 并 保存 到 项 目的 res/xml/ 目 录 下 ， 例 如 : 


<appwidget-provider xmlns:android-"http://schemas.android.com/apk/res/android" 
android:minWidth-"294dp" «!-- density-independent pixels --> 
android:minHeight-"72dp" 
android:updatePeriodMillis-"86400000" «!-- once per day --> 
android:initialLayout-"Glayout/example appwidget" 
android:configure-"com.example.android.ExampleAppWidgetConfigure" > 
</appwidget-provider> 


其 中 : 

* minWidth f minHeight 属性 的 值 指定 了 这 个 App Widget 布局 需要 的 最 小 区 域 。 

* UpdatePerdiodMfillis 属性 定义 了 App Widget 框架 调用 onUpdate() 方 法 来 从 AppWidgetProvider 
请 求 一 次 更 新 的 频率 。 实 际 上 更 新 的 时 间 并 不 精准 。 建 议 更 新 频率 越 低 越 好 ， 比 如 一 小 时 更 
新 一 次 ， 这 样 可 以 节省 电力 ， 或 者 根据 用 户 的 配置 调整 更 新 频率 ， 比 如 有 个 人 每 15 分 钟 想 查 
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看 一 下 股票 的 报价 ， 这 样 可 以 将 频率 设置 为 一 小 时 更 新 4 次 。 
initialLayout 属性 指向 App Widget 使 用 的 布局 的 资源 。 
configure 属性 定义 了 该 App Widget 被 加 载 时 使 用 的 配置 Activity。 


3.5.4 创建 App Widget 布局 


必须 在 res/layout 目录 下 以 XML 文件 的 方式 为 App Widget 定义 一 个 布局 文件 。App Widget 
的 布局 是 基于 RemoteViews 对 象 的 ， 而 RemoteViews 对 象 可 以 支持 以 下 布局 : 





Framelayout 
LinearLayout 
RelativeLayout 
GridLayout 


和 以 下 的 小 组 件 类 : 


AnalogClock 
Button 
Chronometer 
ImageButton 
ImageView 
ProgressBar 
TextView 
ViewFlipper 
ListView 
GridView 
StackView 
AdapterViewFlipper 


但 是 并 不 支持 它们 的 派生 类 。 
此 外 ，RemoteView 还 支持 ViewStub， 该 组 件 不 可 见 ， 自 身 无 尺寸 ， 可 用 于 对 布局 资源 进行 支 


B. 


3.5.5 Jg App Widget 添加 边界 


如 果 没 有 为 自 定义 的 Widget 定义 边界 ， 它 就 会 自动 扩展 到 屏幕 大 小 。 因 此 ， 我 们 需要 为 自 定 
义 的 App Widget 定义 边界 。 

É Android 4.0 开始 , App Widget 会 自动 在 Widget 的 边界 环绕 盒 之 间 添 加 空隙 , 以 便 为 Widget 
和 其 他 小 组 件 以 及 屏幕 上 的 图 标 提供 更 好 的 排列 组 合 方式 。 为 实现 这 个 行为 , 我 们 需要 将 应 用 程序 
中 的 “targetSdkVersion” 属 性 设置 为 大 于 14。 

实际 上 ， 我 们 可 以 自己 定义 一 个 带 有 自 定 义 边界 的 布局 ， 并 且 使 该 布局 在 应 用 于 早期 平台 版 
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本 时 正常 显示 边界 ， 而 在 Android 4.0 以 后 版 本 的 平台 上 不 显示 额外 边界 。 定 义 过 程 如 下 : 
201) 设置 targetSdkVersion 为 大 于 14 的 值 。 
Eo 创建 一 个 布局 ， 并 为 其 设置 dimension 资源 ， 其 边界 信息 由 dimension 资源 设 定 ， 代 


码 如 下 : 


<FrameLayout 
android:layout width-"match parent" 
android:layout height-"match parent" 
android: padding="@dimen/widget_margin"> 


<LinearLayout 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:orientation-"horizontal" 
android:background-"Gdrawable/my widget background" 


«/LinearLayout» 


</FrameLayout> 


E 创建 两 个 dimension 资源 ， 一 个 在 res/values/ 目 录 下 ， 用 于 提供 低 于 Android 4.0 版 本 
的 系统 的 边界 信息 ， 另 一 个 在 res/values-v14 下 ， 用 于 提供 高 于 Android 4.0 版 本 的 操作 系统 的 边界 


信息 。 


例如 ，res/values/dimens.xml 定义 如 下 : 


<dimen name="widget margin">8dp</dimen> 


而 res/values-v14/dimens.xml 定义 如 下 : 


<dimen name="widget margin">0dp</dimen> 


3.5.6 


使 用 AppWidgetProvider 类 


46, AppWidgetProvider 类 是 BroadcastReceiver 类 的 子 类 , 可 以 方便 地 处 理 App Widget 发 出 


的 广播 ， 





因此 ， 其 必须 被 声明 在 清单 文件 中 的 <receiver> 元 素 中 。AppWidgetProvider 只 接受 和 相应 


的 App Widget 相关 的 广播 消息 , 例如 这 个 App Widget 被 更 新 、 被 删除 、 被 启用 或 者 被 禁用 的 时 候 。 
当 这 些 广播 事件 发 生 的 时 候 ，AppWidgetProvider 会 接收 到 以 下 方法 的 调用 请 求 。 





onUpdate(): 每 间隔 一 定时 间 该 方法 就 会 被 调用 用 于 对 App Widget 进行 更 新 。 间 隔 时 间 由 
AppWidgetProviderInfo 元 数据 中 的 updatePeriodMillis 属性 指定 。 当 用 户 添加 App Widget 时 ， 

该 方法 也 会 被 调用 。 因 此 ， 该 方法 中 应 该 执行 必要 的 操作 ， 例 如 为 视图 定义 事件 处 理 器 或 者 
启动 一 个 临时 的 服务 等 。 如 果 你 为 App Widget 定义 了 配置 Activity， 就 应 该 由 配置 Activity 
负责 进行 第 一 次 更 新 ， 而 onUpdate() 方 法 不 会 在 用 户 执行 添加 操作 的 时 候 被 调用 ， 而 只 会 在 
后 期 的 更 新 时 被 调用 。 
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onAppWidgetOptionsChanged(): 该 方法 在 Widget 被 首次 放置 到 应 用 程序 中 或 者 Widget 的 尺 
寸 被 更 改 时 被 调用 。 

onDeleted(Context, int[]): 该 方法 在 App Widget 被 从 App Widget 宿主 中 删除 的 时 候 被 调用 。 
onEnabled(Context): 该 方法 在 App Widget 的 第 一 个 实例 被 创建 时 被 调用 。 若 用 户 添加 了 两 
个 App Widget 的 实例 ， 则 该 方法 只 会 在 第 一 次 添加 时 被 调用 。 如 果 你 需要 打开 数据 库 或 者 其 
他 只 需要 进行 一 次 的 设置 ， 那 么 将 代码 放 在 这 个 方法 中 是 个 不 错 的 主意 。 
onDisabled(Contexb: 该 方法 在 最 后 一 个 App Widget 实例 从 App Widget 宿主 中 被 删除 的 时 候 
调用 。 在 该 方法 中 ， 你 应 该 对 在 onEnabled0 方 法 中 的 操作 进行 善后 ， 例 如 删除 一 个 临时 的 数 
据 库 。 

onReceive(Context, Intent): 每 当 接收 到 一 个 广播 ， 该 方法 都 会 被 调用 。 并 且 ， 该 方法 会 在 上 
述 各 个 方法 之 前 被 调用 。 通 常 我 们 不 需要 重 写 该 方法 ， 因 为 默认 的 AppWidgetProvider 类 已 
经 很 好 地 实现 了 对 所 有 广播 的 过 滤 和 处 理 方法 的 调用 。 


可 见 onUpdate() 方 法 是 最 重要 的 回调 方法 ， 如 果 你 创建 的 App Widget 不 需要 进行 创建 临时 文 
件 等 操作 ， 那 么 你 可 能 只 需要 定义 onUpdate0 方 法 就 可 以 了 。 例 如 ， 当 你 创建 了 一 个 带 有 Button 
的 App Widget， 当 点 击 按 钮 时 会 启动 一 个 Activity， 那 么 你 的 AppWidgetProvider 类 应 该 像 下 面 这 


样 定义 : 














public class ExampleAppWidgetProvider extends AppWidgetProvider { 


public void onUpdate (Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) 


final int N = appWidgetIds.length; 


// Perform this loop procedure for each App Widget that belongs to this provider 
for (int i-0; i<N; i++) { 


int appWidgetId = appWidgetIds[i]; 


// Create an Intent to launch ExampleActivity 
Intent intent = new Intent (context, ExampleActivity.class); 
PendingIntent pendingIntent = PendingIntent.getActivity(context, 0, intent, 0); 


// Get the layout for the App Widget and attach an on-click listener 
// to the button 
RemoteViews views = new RemoteViews (context.getPackageName(), 


R.layout.appwidget provider layout); 


views.setOnClickPendingIntent (R.id.button, pendingIntent); 


// Tell the AppWidgetManager to perform an update on the current app widget 
appWidgetManager.updateAppWidget (appWidgetId, views); 


其 中 ,appWidgetIds 是 一 个 存放 ID 的 数组 , 其 中 的 每 一 个 ID 值 都 标识 一 个 AppWidgetProvider 
创建 的 App Widget。 如 果 该 数组 中 存放 了 多 个 App Widget 的 ID， 那么 这 些 App Widget 会 被 同步 
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3.5.7 接收 App Widget 的 广播 


如 果 你 想 直接 用 自己 的 类 接收 并 处 理 App Widget 的 广播 ， 那 么 你 需要 实现 自己 的 
BroadcastReceiver， 重 写 onReceiver0 方 法 ， 并 处 理 以 下 4 个 Intent: 











ACTION APPWIDGET UPDATE 

ACTION APPWIDGET DELETED 
ACTION APPWIDGET ENABLED 
ACTION APPWIDGET DISABLED 


3.5.8 创建 App Widget 的 配置 Activity 


如 果 想 让 用 户 在 添加 新 的 App Widget 的 时 候 对 颜色 、 尺 寸 、 更 新 周期 等 属性 进行 配置 ， 那 么 
就 需要 创建 一 个 配置 Activity。 配 置 Activity 会 在 App Widget 被 创建 时 由 其 宿主 启动 。 
该 配置 Activity 需要 在 Manifest 文件 中 进行 声明 ， 通 过 ACTION_APPWIDGET_CONFIGURE 
活动 被 宿主 启动 ， 代 码 如 下 : 
<activity android:name=" .ExampleAppWidgetConfigure"> 
<intent-filter> 
<action android:name-"android.appwidget.action.APPWIDGET CONFIGURE" /> 
</intent-filter> 
</activity> 
此 外 , 该 Activity 还 需要 在 AppWidgetProviderInfo XML 中 通过 android:configure 属性 被 声明 ， 
例如 : 
<appwidget-provider xmlns:android-"http://schemas.android.com/apk/res/android" 
ed :configure-"com.example.android.ExampleAppWidgetConfigure" 


2 
</appwidget-provider> 


当 为 App Widget 定义 了 配置 Activity Ja, Widget 在 被 创建 时 不 会 再 调用 onUpdate 方法 。 


3.5.9 使 用 配置 Activity 对 App Widget 进行 更 新 


当 Widget 使 用 了 配置 Activity 后 ， 配 置 Activity 会 在 用 户 完 成 设置 后 对 Widget 进行 更 新 。 通 
过 配置 Activity 对 Widget 进行 更 新 并 关闭 配置 Activity 的 过 程 如 下 : 
€o) WAZ) Activity 的 Intent 中 获取 App Widget 的 ID 值 。 


Intent intent = getIntent(); 
Bundle extras = intent.getExtras(); 
if (extras != null) { 
mAppWidgetId = extras.getInt( 
AppWidgetManager.EXTRA APPWIDGET ID, 
AppWidgetManager.INVALID APPWIDGET ID); 
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€02 执行 App Widget 配置 。 
C203 完成 配置 后 ， 获 取 AppWidgetManager 类 的 实例 。 


AppWidgetManager appWidgetManager = AppWidgetManager.getInstance (context); 
2704 通过 RomoteViews 布局 对 App Widget 进行 更 新 。 


RemoteViews views = new RemoteViews (context.getPackageName(), 
R.layout.example appwidget) ; 
appWidgetManager.updateAppWidget (mAppWidgetId, views); 


eo 创建 返回 Intent, i&& Activity 返回 值 ， 并 关闭 Activity. 


Intent resultValue = new Intent (); 
resultValue.putExtra (AppWidgetManager.EXTRA_APPWIDGET ID, mAppWidgetId) ; 
setResult (RESULT_OK, resultValue) ; 


finish(); 
3.6 ”进程 和 线程 
当 一 个 应 用 组 件 启动 , 并 且 该 应 用 没有 别 的 正在 运行 的 组 件 时 , 则 Android 系统 会 为 这 个 应 用 


程序 创建 一 个 包含 单个 线程 的 linux 进程 。 默认 情况 下 ， 同 一 个 应 用 程序 的 所 有 组 件 都 运行 在 同一 
个 进程 与 线程 中 ( 叫 作 “main” 主 线程 》。 某 个 应 用 组 件 启动 ， 如 果 该 应 用 程序 的 进程 已 经 存在 ( 因 
为 应 用 程序 的 其 他 组 件 已 经 在 运行 了 ) ， 那 么 刚刚 启动 的 组 件 会 在 已 有 的 进程 和 线程 中 启动 运行 。 
不 过 ， 可 以 指定 组 件 运行 在 其 他 进程 中 ， 也 可 以 为 任何 进程 创建 其 他 的 线程 。 

本 节 主 要 讨论 进程 和 线程 是 如 何在 Android 应 用 程序 中 发 挥 作 用 的 。 


3.6.1 进程 


默认 情况 下 ， 同 一 个 应 用 程序 内 的 所 有 组 件 都 是 运行 在 同一 个 进程 中 的 ， 大 部 分 应 用 程序 也 
不 会 去 改变 它 。 不 过 ， 如 果 需 要 指定 某 个 特定 组 件 所 属 的 进程 ， 那 么 可 以 利用 manifest 文件 来 达到 
目的 。 

manifest 文件 中 的 每 种 组 件 元 素 (<activity>、 <service>、 <receiver>fil<provider>) 都 支持 
android:process 属性 ， 用 于 指定 组 件 所 属 运行 的 进程 。 设 置 此 属性 即 可 实现 每 个 组 件 在 各 自 的 进程 
中 运行 , 或 者 某 几 个 组 件 共享 一 个 进程 而 其 他 组 件 不 可 以 参与 。 设 置 此 属性 也 可 以 让 来 自 于 不 同 应 
用 程序 的 组 件 运行 在 同一 个 进程 中 ， 实 现 多 个 应 用 程序 共享 同一 个 Linux 的 user ID， 并 且 提 供 相 
同 的 签名 认证 。 

<application> 元 素 也 支持 android:process 属性 ， 用 于 指定 所 有 组 件 的 默认 值 。 

如 果 内 存 不 足 ， 且 又 有 其 他 为 用 户 提供 更 紧急 服务 的 进程 需要 更 多 内 存 时 ，Android 可 能 会 决 
定 关闭 一 个 进程 。 在 此 进程 中 运行 着 的 应 用 程序 组 件 也 会 因此 被 销毁 。 当 需要 再 次 工作 时 , 会 为 这 
些 组 件 重新 创建 一 个 进程 。 

在 决定 关闭 哪个 进程 的 时 候 ，Android 系统 会 权衡 它们 对 于 用 户 的 重要 程度 。 比 如 ， 相 对 于 一 
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个 拥有 可 视 Activity 的 进程 ， 更 有 可 能 去 关闭 一 个 持 有 一 组 不 再 对 用 户 可 见 的 Activity 的 进程 。 也 
就 是 说 ,， 是否 终止 一 个 进程 取决 于 运行 在 此 进程 中 组 件 的 状态 。 终止 进程 的 判定 规则 将 在 后 续 内 
容 中 讨论 。( 注 : 一 个 进程 的 关闭 级 别 ， 按 照 该 进程 中 最 高 的 级 别 来 定义 ， 如 该 进程 中 有 Activity 
和 Service， 那 么 该 进程 的 级 别 为 Service。) 

Android 系统 试图 尽 可 能 长 时 间 地 保持 应 用 程序 进程 ， 但 为 了 新 建 的 或 者 更 为 重要 的 进程 ， 总 
是 需要 清除 旧 的 进程 以 回收 内 存 。 为 了 决定 保留 或 终止 哪个 进程 , 根据 进程 内 运行 的 组 件 及 这 些 组 
件 的 状态 ， 系 统 把 每 个 进程 都 划 入 一 个 “importance hierarchy” 中 。 重 要 性 最 低 的 进程 首先 会 被 清 
除 ， 然 后 是 其 次 低 的 进程 ， 以 此 类 推 ， 这 都 是 回收 系统 资源 所 必需 的 。 

“importance hierarchy” 共 有 5 级 ， 下 面 按照 重要 程度 列 出 了 各 类 进程 〈 第 一 类 进程 是 最 重要 
的 ， 将 最 后 一 个 被 终止 ) 。 

(1) 前 台 进 程 (Foreground Process) 

用 户 正在 请 求 的 进程 。 当 以 下 任何 一 个 条 件 成 立时 ， 该 进程 被 认为 是 前 台 进 程 ; 
持 有 一 个 用 户 正 在 与 之 交互 的 Activity (Activity 对 象 的 onResume() 方 法 已 被 调用 ). 
持 有 一 个 服务 ( Service )， 且 该 服务 已 被 绑 定 到 一 个 正在 与 用 户 交 互 的 Activity 上 。 
持 有 一 个 服务 ， 且 该 服务 在 前 台 运 行 ， 即 该 服务 startForground() 调 用 . 
持 有 一 个 服务 ， 且 该 服务 正在 执行 其 生命 周期 的 回调 方法 ( onCreate() onStart() . 
onDestroy() )。 
o 持 有 一 个 BroadcastReceiver， 且 其 正在 执行 onReceive() 方 法 。 


通常 ， 在 一 个 给 定 的 时 间 内 ， 只 有 很 少 的 前 台 进 程 存在 。 当 系统 内 存 匮 乏 ， 以 至 于 它们 不 能 
全 部 继续 运行 时 ,它们 会 依 序 被 清除 ,通常 ,这 时 设备 已 经 到 了 内 存 分 页 状态 (memory paging state), 
清除 那些 前 台 进 程 以 确保 用 户 响应 。 

(2) 可 视 进程 (Visible Process) 

一 个 可 视 进程 是 没有 前 台 组 件 的 ， 但 仍 会 影响 用 户 在 屏幕 上 所 见 内 容 的 进程 。 当 以 下 任何 一 
个 条 件 成 立时 ， 该 进程 被 认为 是 可 视 进 程 : 

e 444—* Activity, Hix Activity 没有 处 于 前 台 ， 但 是 对 于 用 户 而 言 它 仍然 可 见 ConPause() 

方法 被 调用 ), 这 是 可 能 发 生 的 , 例如 , 一 个 前 台 Activity 启动 了 一 个 对 话 框 , 而 之 前 的 Activity 
还 允许 显示 在 后 面 。 
© 持 有 一 个 服务 ( Service )， 且 该 服务 被 绑 定 到 一 个 可 视 (或 一 个 前 台 ) Activity. 


一 个 可 视 进 程 是 极其 重要 的 ， 除 非 无 法 维持 所 有 前 台 进 程 同时 运行 了 ， 它 们 是 不 会 被 终止 的 。 
(3) 服务 进程 (Service Process) 

此 进程 运行 着 由 startService() 方 法 启动 的 服务 ， 它 不 会 升级 为 上 述 两 个 级 别 。 尽 管 服务 进程 不 
直接 和 用 户 所 见 内 容 关联 , 但 它们 通常 在 执行 一 些 用 户 关 心 的 操作 (比如 在 后 台 播 放 音 乐 或 从 网 络 
下 载 数据 ) 。 因 此 ， 除 非 内 存 不 足以 维持 所 有 前 台 、 可 视 进 程 同时 运行 ， 系 统 会 保持 服务 进程 的 运 
行 。 

(4) 后 台 进 程 (Background Process) 

一 个 后 台 进 程 持 有 一 个 对 用 户 不 可 见 的 Activity (Activity 对 象 的 onStop() 方 法 已 被 调用 ) 。 这 

些 进程 对 用 户 体验 没有 直接 的 影响 ,系统 可 能 在 任意 时 间 终 止 它们 ,以 回收 内 存 供 前 台 进 程 、 可 视 
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进程 及 服务 进程 使 用 。 通 常会 有 许多 后 台 进 程 运行 ， 所 以 它们 被 保存 在 一 个 LRU (Least Recently 
Used) 列表 中 ， 以 确保 最 近 被 用 户 使 用 的 Activity 最 后 一 个 被 终止 。 如 果 一 个 Activity 正确 实现 了 
生命 周期 方法 ， 并 保存 了 当前 的 状态 ， 则 终止 此 类 进程 不 会 对 用 户 体验 产生 显著 的 影响 。 因 为 当 用 
户 回 到 这 个 Activity， 这 个 Activity 会 恢复 它 所 有 可 视 的 状态 。 关 于 保存 和 恢复 状态 的 详细 信息 ， 
请 参阅 Activities 文档 。 
(5) 空 进 程 (Empty Process) 

空 进程 不 含 任何 活动 应 用 程序 组 件 。 保 留 这 种 进程 的 唯一 目的 就 是 用 作 缓 存 ， 以 改善 下 次 在 
此 进程 中 运行 组 件 的 启动 时 间 。 为 了 在 进程 缓存 和 内 核 缓存 间 平 衡 系 统 整体 资源 , 系统 经 常会 终止 

依据 进程 中 目前 活跃 组 件 的 重要 程度 ，Android 会 给 进程 评估 一 个 尽 可 能 高 的 等 级 。 例 如 ， 一 
个 进程 拥有 一 个 服务 和 一 个 用 户 可 见 的 Activity, 则 此 进程 会 被 评定 为 可 视 进程 , 而 不 是 服务 进程 。 

此 外 ， 一 个 进程 的 等 级 可 能 会 由 于 其 他 进程 的 依赖 而 被 提高 ， 一 个 服务 于 另 一 个 进程 的 进程 
永远 不 能 比 另 一 个 进程 的 等 级 低 。 比 如 ， 进 程 A 中 的 content provider 为 进程 B 中 的 客户 端 提供 服 
务 ， 或 进程 A 中 的 服务 被 进程 B 中 的 组 件 所 调用 ， 则 进程 A 被 认为 其 重要 等 级 不 低 于 进程 B。 
因为 运行 服务 的 进程 级 别 高 于 后 台 Activity 进程 的 等 级 ， 所 以 ， 如 果 Activity 需要 启动 一 个 长 
时 间 运 行 的 操作 ， 则 为 其 启动 一 个 服务 (Service) 会 比 简单 地 创建 一 个 工作 线程 更 好 些 ， 尤 其 是 在 
此 操作 时 间 比 Activity 本 身 存 在 时 间 还 要 长 久 的 情况 下 。 比 如 ， 一 个 Activity 要 把 图 片上 传 至 Web 
网 站 ， 就 应 该 创建 一 个 服务 来 执行 ， 即 使 用 户 离开 此 Activity， 上 传 还 是 会 在 后 台 继 续 运 行 。 无 论 
Activity 发 生 什么 情况 ， 使 用 服务 可 以 保证 操作 至 少 拥有 服务 进程 (service process) 的 优先 级 。 同 
理 ， 前 面 的 广播 接收 器 也 是 使 用 服务 而 非 简 单 地 启用 一 个 线程 。 








3.6.2 ”线程 


应 用 程序 启动 时 ， 系 统 会 为 它 创建 一 个 名 为 “main” 的 主线 程 。 主 线程 非常 重要 ， 因 为 它 负 
责 分 配 事件 到 合适 的 用 户 接口 ， 包 括 绘图 事件 。 它 也 是 应 用 程序 与 Android UI 组 件 包 (来 自 
android.widget 和 android.view 包 ) 进行 交互 的 线程 。 因 此 ， 主 线程 有 时 也 被 叫 作 UI 线程 。 

系统 并 不 会 为 每 个 组 件 的 实例 创建 单独 的 线程 。 运行 于 同一 个 进程 中 的 所 有 组 件 都 是 在 UI 线 
程 中 实例 化 的 ， 对 每 个 组 件 的 系统 调用 也 都 是 由 UI 线程 分 配 的 。 因 此 ， 对 系统 回调 进行 响应 的 方 
法 《比如 报告 用 户 操作 的 ooKeyDown0 或 生命 周期 回调 方法 ) 总 是 运行 在 UI 线程 中 。 

例如 ， 当 用 户 触摸 屏幕 上 的 按钮 时 ， 应 用 程序 的 UI 线程 会 把 触摸 事件 分 发 给 widget, widget 
先 把 自己 置 为 按 下 (pressed) RE, 再 发 送 一 个 显示 区 域 已 失效 (invalidate) 的 请 求 到 事件 队列 中 。 
UI 线程 从 队列 中 取出 此 请 求 ， 并 通知 widget 重 绘 自己 。 

如 果 应 用 程序 在 与 用 户 交互 的 同时 需要 执行 繁重 密集 的 任务 ， 单 线程 模式 可 能 会 导致 运行 性 
能 很 低下 ， 除 非 应 用 程序 的 执行 时 机 很 合适 。 如 果 UI 线程 需要 处 理 每 一 件 事 情 ， 那 些 耗 时 很 长 的 
操作 (诸如 访问 网 络 或 查询 数据 库 等 ) 将 会 阻塞 整个 UI (线程 ) 。 一 旦 线程 被 阻塞 ， 所 有 事件 都 
不 能 被 分 发 , 包括 屏幕 绘图 事件 。 从 用 户 的 角度 来 看 , 应 用 程序 看 上 去 似乎 被 挂 起 了 。 更 糟糕 的 是 ， 
如 果 UI 线程 被 阻塞 超过 一 定时 间 《〈 目 前 设置 大 约 是 5 秒 钟 ) ， 用 户 就 会 被 提示 那个 可 恶 的 “应 用 
程序 没有 响应 ” (ANR) 。 如 果 引 起 用 户 不 满 ， 可 能 就 会 决定 退出 并 删除 这 个 应 用 程序 。 
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此 外 ，Android 的 UI 组 件 包 并 不 是 线程 安全 的 ， 因 此 不 允许 从 工作 线程 中 操作 UI， 只 能 
UI 线程 中 操作 用 户 界面 。 因 此 ，Android 的 单线 程 模式 必须 遵守 两 个 规则 : 


e 不 允许 阻塞 Ul AS. 
© KA Ul 线程 之 外 访问 Android 的 UI 组 件 包 。 


根据 以 上 对 单线 程 模式 的 描述 ， 要 想 保 证 程序 界面 的 响应 能 力 ， 关 键 是 不 能 阻塞 UI 线程 。 如 
果 操 作 不 能 很 快 完成 ， 就 让 它们 在 单独 的 线程 中 运行 “后台 ”或 “工作 ”线程 )。 
例如 ， 以 下 是 响应 鼠标 单 击 的 代码 ， 实 现 了 在 单独 线程 中 下 载 图 片 并 在 ImageView 显示 的 功 
能 。 
public void onClick(View v) { 
new Thread(new Runnable() { 
public void run() { 
Bitmap b = loadImageFromNetwork ("http://example.com/image.png") 
mImageView.setImageBitmap (b); 





$ 
}) -start (); 


首先 ， 因 为 创建 了 一 个 新 的 线程 来 处 理 访问 网 络 的 操作 ， 这 段 代 码 似乎 能 运行 得 很 好 。 可 是 
它 违反 了 单线 程 模式 的 第 二 条 规则 , 即 不 要 在 UI 线程 之 外 访问 Android 的 UI 组件 包 。 这 个 例子 在 
工作 线程 里 而 不 是 UI 线程 里 修改 了 ImageView， 这 可 能 导致 不 明确 、 不 可 预见 的 后 果 ， 要 跟踪 这 
种 情况 也 是 很 困难 很 耗 时 的 。 

为 了 解决 以 上 问题 ，Android 提供 了 几 种 方法 ， 从 其 他 线程 中 访问 UI 线程 。 下 面 列 出 了 有 助 
于 解决 问题 的 几 种 方法 : 

e ActivityrunOnUiThread(Runnable) 

e Viewpost(Runnable) 





e View.postDelayed(Runnable, long) 
例如 ， 可 以 使 用 View.post(Runnable) 方 法 来 修正 上 面 的 代码 : 


public void onClick(View v) { 
new Thread(new Runnable() { 
public void run() { 
final Bitmap bitmap = 
loadImageFromNetwork ("http: //example.com/image.png"); 
mImageView.post(new Runnable() { 
public void run() { 
mImageView.setImageBitmap (bitmap); 
) 
n: 
} 
)).start(); 


现在 , 这 段 代 码 的 执行 是 线程 安全 的 了 。 网 络 相 关 的 操作 在 单独 的 线程 里 完成 , 而 ImageView 
是 在 UI 线 程 里 操纵 的 。 
不 过 ， 随 着 操作 变 得 越 来 越 复杂 ， 这 类 代码 也 会 变 得 复杂 难以 维护 。 为 了 用 工作 线程 完成 更 
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加 复杂 的 交互 处 理 ， 可 以 考虑 在 工作 线程 中 用 Handler 来 处 理 UI 线程 分 发 过 来 的 消息 。 当 然 ， 最 
好 的 解决 方案 也 许 就 是 继承 使 用 异步 任务 类 AsyncTask， 此 类 简化 了 一 些 工作 线程 和 UI 交互 的 操作 。 
(2) 使 用 异步 任务 (AsyncTask) 

异步 任务 允许 以 异步 的 方式 对 用 户 界面 进行 操作 。 它 先 阻塞 工作 线程 ， 再 在 UI 线程 中 呈现 结 
果 ， 在 此 过 程 中 不 需要 对 线程 和 Handler 进行 人 工 干预 。 

要 使 用 异步 任务 ， 必 须 继承 AsyncTask 类 并 实现 doInBackground0 回 调 方法 ， 该 对 象 将 运行 于 
一 个 后 台 线 程 池 中 。 要 更 新 UI 时 ， 需 实现 onPostExecute() 方 法 来 分 发 doInBackground0 返 回 的 结 
Ro 由 于 此 方法 运行 在 Ul 线程 中 , 因此 能 够 安全 地 更 新 UI。 然后 就 可 以 在 UI 线程 中 调用 execute) 
来 执行 任务 了 。 

例如 ， 可 以 利用 AsyncTask 来 实现 上 面 的 例子 : 


public void onClick(View v) { 
new DownloadImageTask().execute ("http://example.com/image.png"); 











} 


private class DownloadImageTask extends AsyncTask<String, Void, Bitmap> { 
/** The system calls this to perform work in a worker thread and 
* delivers it the parameters given to AsyncTask.execute() */ 
protected Bitmap doInBackground(String... urls) { 
return loadImageFromNetwork (urls [0]); 


) 


/** The system calls this to perform work in the UI thread and delivers 
* the result from doInBackground() */ 
protected void onPostExecute (Bitmap result) { 
mImageView.setImageBitmap (result); 


} 


现在 的 UI 是 安全 的 ， 代 码 也 得 到 了 简化 ， 因 为 任务 分 解 成 了 工作 线程 内 完成 的 部 分 和 UI 2X 
程 内 完成 的 部 分 。 

要 全 面 理 解 这 个 类 的 使 用 ， 需 阅读 AsyncTask 的 参考 文档 。 以 下 是 关于 其 工作 方式 的 概述 : 
可 以 用 generics 来 指定 参数 的 类 型 、 进 度 值 和 任务 最 终 值 。 
工作 线程 中 的 doInBackground() 方 法 会 自动 执行 。 
onPreExecute()、onPostExecute() 和 onProgressUpdate() 方 法 都 在 UI 线程 中 调用 。 
doInBackground0) 的 返回 值 会 传 给 onPostExecute()。 
在 doInBackgroundO 内 的 任何 时 刻 ， 都 可 以 调用 publishProgress0 来 执行 UI 线程 中 的 
onProgressUpdate().. 
© 可 以 在 任何 时 刻 、 任 何 线程 内 取消 任务 . 


在 使 用 工作 线程 时 ， 可 能 遇 到 的 另 一 个 问题 是 ， 由 于 运行 配置 的 改变 (比如 用 户 改 变 了 屏 


幕 方向 ) 导致 Activity 意外 重启 ， 这 可 能 会 销毁 该 工作 线程 。 要 了 解 如 何在 这 种 情况 下 维持 
任务 执行 以 及 如 何在 Activity 被 销毁 时 正确 地 取消 任务 ， 请 参见 Shelves 例 程 的 源 代码 。 
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3.6.3 ”线程 安全 方法 


在 一 些 情况 下 ， 实 现 的 方法 可 能 会 被 多 个 线程 调用 ， 因 此 应 该 设计 为 线程 安全 的 。 

真是 存在 能 被 远程 调用 的 方法 (比如, WERS bound service) 中 的 方法 ) ， 当 一 个 方法 (在 
一 个 IBinder 中 实现 ) 的 调用 发 起 于 同一 个 进程 CIBinder 正 运行 的 ) 时 ， 这 个 方法 在 调用 者 线程 中 
执行 。 但是， 如 果 调用 发 起 于 其 他 进程 ,那么 这 个 方法 将 运行 于 线程 池 中 选 出 的 某 个 线程 中 (而 不 
是 运行 于 进程 的 UI 线程 中 ) ， 该 线程 池 由 系统 维护 且 位 于 IBinder 所 在 的 进程 中 。 例 如 ， 即 使 一 
个 服务 的 onBind0 方 法 是 从 服务 所 在 进程 的 UI 线程 中 调用 的 ， 实现 了 onBind0 的 方法 对 象 ( 比 如， 
一 个 子 类 实现 了 RPC 的 方法 ) 仍 会 从 线程 池 中 的 线程 被 调用 。 因 为 一 个 服务 可 以 有 多 个 客户 端 ， 
所 以 同时 可 以 有 多 个 线程 池 与 同一 个 IBinder 方法 相关 联 。 因此, IBinder 方法 必须 实现 为 线程 安全 
的 。 

类 似 地 ，content provider 也 能 接收 来 自 其 他 进程 的 数据 请 求 。 尽 管 ContentResolver 类 、 
ContentProvider 类 隐藏 了 进程 间 通 信 管理 的 细节 ，ContentProvider 中 响应 请 求 的 方法 有 : query). 
insert). delete), update()fll getType0 方 法 ， 这 些 方法 都 会 从 ContentProvider 所 在 进程 的 线程 池 中 
被 调用 ， 而 不 是 进程 的 UI 线程 。 由 于 这 些 方法 可 能 会 从 很 多 线程 中 同时 被 调用 ， 因 此 它们 也 必须 
实现 为 线程 安全 的 。 








3.6.4 ”进程 间 的 通信 


Android 利用 远程 过 程 调用 (Remote Procedure Call, RPC) 提供 了 一 种 进程 间 通 信 (IPC) 机 
制 ， 通 过 这 种 机 制 ， 被 Activity 或 其 他 应 用 程序 组 件 调用 的 方法 将 (在 其 他 进程 中 ) 被 远程 执行 ， 
而 所 有 的 结果 将 被 返回 给 调用 者 。 这 就 要 求 把 方法 调用 及 其 数据 分 解 到 操作 系统 可 以 理解 的 程度 ， 
并 将 其 从 本 地 的 进程 和 地 址 空间 传输 至 远程 的 进程 和 地 址 空间 ,然后 在 远程 进程 中 重新 组 装 并 执行 
这 个 调用 。 执 行 后 的 返回 值 将 被 反 向 传输 回来 。Android 提供 了 执行 IPC 事务 所 需 的 全 部 代码 ， 因 
此 只 要 关注 定义 和 实现 RPC 编程 接口 即 可 。 

要 执行 PC, 应 用 程序 必须 用 bindService() 绑 定 到 服务 上 。 详情 请 参阅 服务 Services 开发 文档 。 


3.7 小 结 


本 章 主要 介绍 了 以 下 内 容 : 


(1) Android 应 用 程序 的 基本 组 成 , 包括 Activity、 Service、 BroadcastReceiver、 ContentProvider、 
Intent. 

(2) Activity 的 创建 、 生 命 周 期 以 及 之 间 数 据 传递 的 方法 。 

(3) Android 资源 的 创建 以 及 使 用 ，AndroidManifestxml 定义 应 用 程序 及 其 组 件 的 结构 和 源 
数据 。 
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1. 简 述 Activity 的 生命 周期 。 

2. 比较 Activity 之 间 数 据 传递 三 种 方法 的 优 缺点 。 

3. 尝试 创建 自己 的 Activity， 并 进行 数据 传递 。 

4. Android 应 用 程序 的 四 大 组 件 是 什么 ? 分 别 有 什 么 作用 ? 


Android GUI 开发 


Android 系统 提供 了 丰富 的 可 视 化 界面 组 件 ， 包 括 菜单 、 按 钮 、 对 话 框 等 。Android 系统 采用 
Java 程序 设计 中 的 UI 设计 思想 ， 其 中 包括 事件 处 理 机 制 及 布局 管理 方式 。Android 系统 中 的 所 有 
UI 类 都 是 建立 在 View 和 ViewGroup 两 个 类 的 基础 之 上 的 ， 所 有 View 的 子 类 称 为 Widget， 所 有 
ViewGroup 的 子 类 称 为 Layout。 本 章 将 详细 介绍 Android N 的 基础 功能 单元 一 Activity 的 用 户 界 
ij UL 设计 、 用 户 界面 UI 组件 及 其 事件 处 理 的 相关 知识 。 


4.1 View 和 ViewGroup 


Activity 是 Android 应 用 程序 与 用 户 交互 的 接口 ， 每 一 个 屏幕 视图 都 对 应 一 个 Activity。 其 实 
Activity 本 身 无 法 显示 在 屏幕 上 , 其 更 像 一 个 用 于 装载 可 显示 组 件 的 容器 。 这 就 好 比 一 个 ISP 页 面 ， 
它 本 身 并 没有 显示 出 来 任何 东西 ， 负 责 显示 的 是 ISP 页 面 内 的 各 种 HTML 标签 ， 而 ISP 页 面 好 比 
一 个 容器 ， 负 责 将 这 些 表 情 装 载 到 页 面 内 。 那 么 在 Android 应 用 程序 里 ， 谁 才 是 真正 负责 显示 的 那 
部 分 呢 ? 答案 是 View 和 ViewGroup， 其 中 ViewGroup 是 View 的 子 类 。 

Android UI 界面 是 通过 View (PLE) 和 ViewGroup 及 其 派生 类 组 合 而 成 的 。 其 中 View 是 所 
有 UI 组 件 的 基 类 ， 基 本 上 所 有 的 高 级 UI 组 件 都 是 继承 View 类 实现 的 ， 如 TextView( 文 本 框 〉、 
Button, List, EditText (编辑 框 ) 、Checkbox 等 。 一 个 View 在 屏幕 占据 一 块 矩 形 区 域 ， 负 责 演 染 
这 块 矩形 区 域 ,也 可 以 处 理 这 块 矩形 区 域 发 生 的 事件 , 并 可 以 设置 该 区 域 是 否 可 见 以 及 获取 焦点 等 。 
而 ViewGroup 是 容纳 这 些 组 件 的 容器 ， 其 本 身 也 是 从 View 中 派生 出 来 的 ， 它 继承 于 
Androidview.View， 功 能 就 是 装载 和 管理 下 一 层 的 View 对 象 或 ViewGroup 对 象 ， 也 就 是 说 它 是 一 
个 容纳 其 他 元 素 的 容器 ,负责 对 添加 进来 的 View 和 ViewGroup 进行 管理 和 布局 .View 和 ViewGroup 
的 关系 如 图 4.1 所 示 。 
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ViewGroup 


public abstract class 


ViewGroup 


ViewGroup View View extends View i 
implements ViewManager ViewParent 


java.lang.Object 
Landroid view. View 
Landroid.view ViewGroup 











图 4.1 View 和 ViewGroup 的 关系 图 


从 图 4.1 可 以 看 到 ，ViewGroup 可 以 包含 一 个 或 任意 个 View 〈 视 图 ) ， 也 可 以 包含 作为 更 低 
层次 的 子 ViewGroup， 而 子 ViewGroup 又 可 以 包含 下 一 层 的 叶子 节点 的 View 和 ViewGroup。 这 种 
灵活 的 层次 关系 可 以 形成 复杂 的 UI 布局 。 在 开发 过 程 中 形成 的 用 户 界面 UI 一 般 来 自 于 View 和 
ViewGroup 类 的 直接 子 类 或 者 间接 子 类 。 

例如 , View 派生 出 的 直接 子 类 有 AnalogClock, ImageView, KeyboardView, ProgressBar, Space, 
SurfaceView、TextView、TextureView、ViewGroup、ViewStub 等 。ViewGroup 派生 出 的 直接 子 类 
有 AbsoluteLayout, FragmentBreadCrumbs, FrameLayout, GridLayout, LinearLayout, RelativeLayout, 
SlidingDrawer 等 。 本 章 不 能 对 View 和 ViewGroup 的 所 





有 子 类 都 进行 详细 的 介绍 ， 只 能 简单 介绍 其 中 常用 的 一 所 r m Andr ExAndroidstudioProjectsWHelloAndroid 
小 部 分 。 如 果 需 要 了 解 各 Ul 组 件 的 相关 信息 , 请 参考 相 | > Dies 
关 文档 。 * ode 
* [3 HelloAndroid [HelloAndroid-HelloAndroid] 
> D build 
Yam y Ose 
42 使 用 XML 定义 视图 "e 


* Bl introduction.android.helloAndroid 
© ù HelloAndroidActivity 
v Cares 








在 使 用 XML 构建 一 个 用 户 界面 之 前 ， 我 们 需要 重 tl, 
温 一 下 Android 工程 的 目录 结构 。 如 图 4.2 所 示 ， 以 > [È drawable-mdpi 
HelloAndroid Xl, project 视图 列 出 了 工程 的 目录 结构 。 ia cm 
以 .开头 的 目录 是 AS 生成 的 辅助 目录 ， 无 须 用 户 干预 。 S uns 
HelloAndroid 文件 夹 是 模块 目录 ， 编 程 工作 主要 集中 在 © build grade 





这 个 目录 中 ， 相 当 于 使 用 Eclipse 构建 的 工程 文件 夹 , & | omma ten 
f; build. src. res 等 文件 夹 。 其 中 ，res 目录 为 Android d PEA 

工程 中 所 使 用 的 资源 目录 , 用 户 UI 所 涉及 的 资源 基本 都 tha 
放置 在 该 目录 下 。res 目录 下 的 每 一 项 资源 文件 都 会 由 [à local properties 

AAPT (Android Asset Packaging Tool) 为 其 生成 一 个 对 |. ga Se 

应 的 public static final 类 型 的 ID 号 , 放置 到 build 目录 下 


的 Rjava 文件 中 ，Android 系统 根据 该 ID 号 来 访问 对 应 图 42 Android 工程 的 目录 结构 
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资源 。build 目录 由 AS 自动 生成 , 不 需要 用 户 修改 ， 由 系统 维护 。res/drawable/ 目录 用 来 存放 工程 
中 使 用 到 的 图 片 文件 ，drawable 之 后 的 hdpi、ldpi、mdpi 分 别 放 高 分 辩 率 、 低 分 辩 率 和 中 分 辩 率 的 
图 片 以 适应 不 同 分 辩 率 的 手机 ，Android 系统 会 根据 用 户 手 机 的 配置 信息 自动 选取 合适 分 辩 率 的 图 
片 文件 ， 无 须 程 序 员 干预 ，res/layout/ 目 录 下 存放 着 定义 UI 布局 文件 用 的 XML 文件 ， 默 认 文件 名 
为 main.xml; res/values/ 目 录 下 存放 着 用 于 存储 工程 中 所 使 用 到 的 一 些 字符 串 信 息 的 文件 ， 默 认 文 
件 名 为 strings.xml。 当 然 ， 每 个 目录 下 都 可 以 存放 多 个 XML 文件 ， 可 由 开发 者 自行 创建 。 由 此 可 
见 ，Android 工程 中 使 用 的 用 户 UI 设计 以 及 用 户 UI 中 涉及 的 字符 串 都 是 由 XML 文件 来 存储 的 。 
Android 系统 使 用 XML 文件 来 定义 用 户 视图 。 
单 击 打开 values 文件 夹 下 的 string.xml 文件 显示 出 如 下 代码 : 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<string name="hello">Hello Android!</string> 
<string name-"app name">HelloAndroid</string> 
</resources> 


文件 的 开头 部 分 <?xml version="1.0" encoding-"utf-8'?»5E X. Y XML 的 版 本 号 和 字符 编码 ， 这 
个 部 分 在 所 有 的 XML 文件 中 都 会 有 ， 由 系统 自动 添加 ， 不 需要 修改 。<resources> 标 签 定义 了 hello 
和 app name 两 个 变量 , 可 以 被 HelloAndroid 工程 直接 使 用 。 当 该 文件 被 修改 时 ,gen 目录 下 的 Rjava 
文件 也 会 跟随 进行 更 新 。 

双击 main.xml 文件 ， 代 码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 











<LinearLayout xmlns:android="http://schemas. android. com/apk/res/android" 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
android: orientation="vertical"> 
<TextView 
android: id="@id/textViewl" 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android: text="@string/hello" /> 
</LinearLayout> 
<LinearLayout> 标 签 定义 了 当前 视图 使 用 的 是 LinearLayout 布局 ， 也 叫 作 线 性 布局 ， 这 是 最 常 
用 的 布局 方式 , Android SDK 还 提供 其 他 的 几 种 布局 方式 , 我 们 会 在 后 面 的 章节 中 进行 详细 的 介绍 。 
在 <LinearLayout> 标 签 中 定义 了 该 布局 方式 的 相关 属性 。android: layout width-"fill parent" 和 
android:layout_height="fill_ parent" 表 示 该 布局 的 宽 和 高 充满 整个 手机 屏幕 ， 
android:orientation="vertical" 表 示 该 布局 中 所 放 入 的 组 件 的 排列 方式 为 纵向 排列 。 
在 <LinearLayout -> 和 </LinearLayout> 之 间 可 以 添加 各 种 UI 组 件 并 设置 组 件 的 相关 属性 ， 例 
如 组 件 的 高 度 、 宽 度 、 内 容 等 ， 在 4.4 节 会 详细 介绍 各 种 常见 组 件 的 使 用 方法 。 在 HelloAndroid 实 
例 中 添加 的 是 一 个 TextView 组 件 ， 相 当 于 一 个 显示 内 容 的 标签 。android:layout width="fill parent" 
指定 其 宽度 覆盖 满 容器 的 宽 ，android:layout height= "wrap_content" 指 定 其 高 度 跟随 其 显示 内 容 变 
化 。android:id="(@id/textView1" 指 明 该 TextView 的 ID 值 为 Rjava 文件 中 ID 类 的 成 员 常量 
textViewl. Android SDK 提供 了 @[<package_name>:]<resource_type>/<resource_ name> 方 式 ， 以 便 
于 从 XML 文件 中 访问 工程 的 资源 。 android:text="(@string/hello" 指 明 该 TextView 组 件 显示 的 内 容 为 
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资源 文件 string. xml 中 定义 的 hello 变量 的 内 容 。android:text 属性 也 可 以 直接 指定 要 显示 的 字符 串 ， 
但 是 在 实际 的 工程 开发 过 程 中 不 鼓励 这 种 方式 , 而 应 该 使 用 资源 文件 中 的 变量 , 因为 这 样 便于 工程 
维护 和 国际 化 。 在 本 书 中 , 为 了 节省 篇 幅 , 部 分 显示 内 容 简单 的 组 件 使 用 了 字符 串 直 接 赋 值 的 方法 。 
Android 工程 中 使 用 到 的 资源 文件 都 会 在 gen 目录 下 的 Rjava 中 生成 对 应 项 , 由 系统 为 每 个 资 
源 分 配 一 个 十 六 进 制 的 整 型 数值 ， 唯 一 标明 每 个 资源 。 
HelloAndroid 工程 中 的 Rjava 文件 代码 如 下 : 


package introduction.android.helloAndroid; 





public final class R { 
public static final class attr { 
} 
public static final class drawable { 
public static final int ic launcher-0x7f020000; 
} 
public static final class id { 
public static final int textView1-0x7f050000; 
5 
public static final class layout ( 
public static final int main-0x7f030000; 
) 
public static final class string ( 
public static final int app name-0x7f£040001; 
public static final int hello-0x7f040000; 
) 
) 


由 该 文件 可 见 ，R 为 静态 最 终 类 。 其 中 public static final class layout 代表 的 是 res/layout 文件 夹 
的 内 容 , layout 类 的 每 个 整 型 常量 代表 该 文件 夹 下 的 一 个 XML 布局 文件 。 例 如 , public static final int 
main 代表 的 是 main.xml 文件 ，0x7f030000 为 系统 main.xml 文件 生成 的 整 型 数值 。 在 Android 工程 
中 根据 该 数值 找到 main.xml 文件 .public static final class string 代表 的 是 res/values/strings.xml 文件 ， 
string 类 中 的 每 个 整 型 常量 型 成 员 代 表 strings.xml 文件 中 定义 的 一 个 变量 。 例 如 ,public static final int 
app_name 代表 strings.xml 中 定义 的 app_name 变量 ，public static final int hello 代表 stings.xml 文件 
中 定义 的 hello 变量 。 

在 工程 开发 过 程 中 ， 可 以 通过 [<package_name>.]R.<resource_type>.<resource_name> 方 式 来 访 
H R 中 定义 的 任意 资源 。 其 中 package name 为 资源 文件 被 放置 的 包 路 径 ， 一 般 可 以 省 略 。 
resource type 为 资源 类 型 ， 例 如 layout, string. color. drawable, menu ^$. resource name 指 的 是 
为 资源 文件 在 类 中 定义 的 整 型 常量 的 名 字 ， 例 如 : 


setContentView (R.layout.main) ; 


这 行 代码 中 ， 通 过 Rlayout.main 找到 了 布局 文件 main.xml， 并 通过 setContentView 方法 将 其 
设置 为 当前 Activity 的 视图 。 要 从 视图 中 查找 某 个 组 件 ， 需 要 使 用 findViewById 方法 ， 通 过 组 件 
ID 获取 组 件 的 对 象 。 例 如 ， 要 获取 main.xml 中 的 TextView 组 件 对 象 ， 需 要 执行 以 下 代码 : 


TextView textview- (TextView) findViewById (R.id.textViewl) ; 
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Android SDK 定义 了 多 种 布局 方式 以 方便 用 户 设计 UI。 各 种 布局 方式 均 为 ViewGroup 类 的 子 
类 ,结构 如 图 4.3 所 示 。 本 节 将 对 FrameLayout( 单 帧 布局 )、LinearLayout( 线 性 布局 )、AbsoluteLayout 
(绝对 布局 ) ~ RelativeLayout (相对 布局 ) 和 TableLayout (表格 布局 ) 进行 简单 的 介绍 。 








ViewGroup 


AbsoluteLayout LinearLayout RelativeLayout FrameLayout AdapterView 
<T extends 
| Adapter> 






































TabWidget TableLayout TableHost 









































图 43 Android SDK 布局 方式 结构 图 


4.3.4 FrameLayout 


FrameLayout 又 称 单 帧 布局 ,是 Android 所 提供 的 布局 方式 
里 最 简单 的 布局 方式 ， 它 指定 屏幕 上 的 一 块 空白 区 域 ， 在 该 区 
域 填充 一 个 单一 对 象 ， 例 如 图 片 、 文 字 、 按 钮 等 。 应 用 程序 开 
发 人 员 不 能 为 FrameLayout 中 填充 的 组 件 指定 具体 填充 位 置 ， 
默认 情况 下 ， 这 些 组 件 都 将 被 固定 在 屏幕 的 左上 角 ， 后 放 入 的 
组 件 会 放 在 前 一 个 组 件 上 进行 覆盖 填充 ， 形 成 部 分 遮挡 或 全 部 
遮挡 。 开 发 人 员 可 以 通过 组 件 的 android:layout_gravity 属性 对 
组 件 位 置 进行 适当 的 修改 。 

实例 FrameLayoutDemo 演示 了 FrameLayonut 的 布局 效果 。 
该 布局 中 共有 4 个 TextView 组 件 , 前 3 个 组 件 以 默认 方式 放置 
到 布局 中 ,第 4 个 组 件 修改 gravity 属性 后 放置 到 布局 中 ,运行 
效果 如 图 4.4 所 示 。 

实例 FrameLayoutDemo 中 的 布局 文件 main.xml 的 代码 如 











图 4.4 ”FrameLayout 的 布局 效果 


<?xml version="1.0" encoding-"utf-8"?» 
<FrameLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: layout_width="fill parent" 
android: layout_height="fill_parent"> 
<TextView 
android: id="@tid/text1” 
android: layout_width="wrap content" 


android: layout_height="wrap content" 
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android: textColor="#00f£00" 
android:textSize-"100dip" 
android:text="@string/first"/> 


<TextView 
android: id="@tid/text2" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android: textColor="#00ffff" 
android:textSize-"70dip" 
android:text="@string/second"/> 
<TextView 
android: id="@tid/text3" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android:textColor-"£ff0000" 
android:textSize-"40dip" 
android:text="@string/third"/> 
<TextView 
android: id="@tid/text4" 
android: layout_width="wrap content" 
android: layout_height="wrap_ content" 
android: textColor="#ffff00" 
android: textSize="40dip"” 
android: layout_gravity="bottom" 
android:text="@string/forth"/> 
</FrameLayout> 


其 中 : 


android:layout width="wrap content" 
android:layout height-"wrap content" 


表明 FrameLayout 布局 覆盖 了 整个 屏幕 空间 。 
实例 FrameLayoutDemo 中 的 string.xml 文件 内 容 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
<resources> 
<string name="app_name">FrameLayoutDemo</string> 

first"> 第 一 层 </string> 

<string name="second"> 第 二 层 </string> 

<string name="third"> 第 三 层 </string> 

«string name="forth"> 第 四 层 </string> 
</resources> 


从 运行 后 的 结果 可 见 ， 前 3 个 被 放置 到 FrameLayout 的 TextView 组 件 都 是 以 屏幕 左上 角 为 基 
点 进行 合 加 的 。 第 4 个 TextView 因为 设置 了 android:layout_gravity="bottom" 属 性 而 显示 到 了 布局 
的 下 方 。 读 者 可 自行 将 android:layout_gravity 属性 值 修改 为 其 他 属性 ， 查 看 运行 效果 。 





4.3.2 LinearLayout 


LinearLayout 又 称 线性 布局 ， 该 布局 应 该 是 Android 视图 设计 中 最 经 常 使 用 的 布局 。 该 布局 可 
以 使 放 入 其 中 的 组 件 以 水 平方 式 或 者 垂直 方式 整齐 排列 ， 通 过 android:orientation 属性 指定 具体 的 
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排列 方式 ， 通 过 weight 属性 设置 每 个 组 件 在 布局 中 所 占 的 比 
实例 LinearLayoutDemo 演示 了 LinearLayout 布局 的 使 用 方法 ， 效 果 如 图 4.5 所 示 。 








| Linear ayoutDemo 


ted blue 


row one 
row two 


row three 


row four 





图 4.5 LinearLayout 的 布局 效果 


实例 LinearLayoutDemo 中 的 strings.xml 文件 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<string 
<string 


="app_name">LinearLayoutDemo</string> 
red">red</string> 

<string yellow">yellow</string> 

<string green" >green</string> 

<string name="blue">blue</string> 

<string rowl"»row one</string> 

<string name="row2">row two</string> 

<string name="row3">row three</string> 

<string name="row4">row four</string> 
</resources> 


实例 LinearLayoutDemo 中 的 布局 文件 main.xml 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 






<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 


android: orientation="vertical" 
android: layout_width="fill_ parent" 
android: layout_height="fill_parent"> 


<LinearLayout 

android: orientation="horizontal” 

android: layout_width="fill_ parent" 

android: layout_height="fill parent" 

android: layout_weight="1"> 

<TextView 

android:text="@string/red"™ 
android:gravity-"center horizontal" 
android:background="#aa0000" 
android: layout width-"wrap content" 
android: layout_height="fill_ parent" 
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android:layout weight-"1"/» 

<TextView 
android:text="@string/green" 
android:gravity-"center horizontal" 
android:background="#00aa00" 
android: layout_width="wrap content" 
android: layout_height="£ill_ parent" 
android: layout_weight="1"/> 

<TextView 
android:text="@string/blue" 
android:gravity-"center horizontal" 
android:background="#0000aa" 
android: layout_width="wrap content" 
android: layout_height="fill parent" 
android: layout_weight="1"/> 

<TextView 
android:text="@string/yellow” 
android:gravity-"center horizontal" 
android:background-"£aaaa00" 
android:layout width-"wrap content" 
android:layout height-"fill parent" 
android:layout weight-"1"/» 

</LinearLayout> 


<LinearLayout 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android: layout_weight="1"> 
<TextView 
android:text="@string/rowl" 
android: textSize="15pt" 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
android:layout weight-"1"/» 
<TextView 
android:text="@string/row2" 
android: textSize="15pt" 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
android:layout weight-"1"/» 
<TextView 
android:text="@string/row3" 
android: textSize="15pt" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:layout weight-"1"/» 
<TextView 
android:text="@string/row4" 
android: textSize="15pt" 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
android:layout weight-"1"/» 
</LinearLayout> 
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</LinearLayout> 


该 布局 中 放置 了 两 个 LinearLayout 布局 对 象 。 第 一 个 LinearLayout 布局 通过 android: 
orientation="horizontal" 属性 将 布局 设置 为 横向 线性 排列 ， 第 二 个 LinearLayout 布局 通过 
android:orientation="vertical" 属 性 将 布局 设置 为 纵向 线性 排列 。 每 个 LinearLayout 布局 中 都 放 入 了 4 
个 TextView， 并 通过 android:layout_weight 属性 设置 每 个 组 件 在 布局 中 所 占 的 比重 相同 ， 即 各 组 件 
大 小 相同 。layout weight 用 于 定义 一 个 线性 布局 中 某 组 件 的 重要 程度 。 所 有 的 组 件 都 有 一 个 
layout weight 值 ， 默 认为 0， 意 思 是 需要 显示 多 大 的 视图 就 
占据 多 大 的 屏幕 空间 。 若 赋值 为 大 于 0 的 值 ， 则 将 可 用 的 空 
间 分 割 ， 分 割 的 大 小 取决 于 当前 的 layout. weight 数值 与 其 他 Bl LinearLayoutDemo 
空间 的 layout_weight 值 的 比率 ,例如 水 平方 向 上 有 两 个 按钮 ， Vs A 
每 个 按钮 的 layout weight 数值 都 设置 为 1， 那 么 这 两 个 按钮 
平分 宽度 ; 若 第 一 个 为 1， 第 二 个 为 2， 则 可 将 空间 的 三 分 之 
一 分 给 第 一 个 ， 三 分 之 二 分 给 第 二 个 。 

将 LinearLayoutDemo 中 水 平 LinearLayout 的 第 4 个 


TextView 的 android:layout weight 属性 赋值 为 2, 运行 效果 如 row one 
图 4.6 所 示 。 
row two 
LinearLayout Hija P(E KES. WHA LinearLayout 布局 
可 以 设计 出 各 种 各 样 漂亮 的 布局 方式 。 row three 


row four 





4.3.5 RelativeLayout 图 4.6 修改 android:layout_weight 属性 
RelativeLayout 又 称 相对 布局 。 从 名 称 上 可 以 看 出 ， 这 种 布局 方式 是 以 一 种 让 组 件 以 相对 于 容 
器 或 者 相对 于 容器 中 的 另 一 个 组 件 的 相对 位 置 进行 放置 的 布局 方式 。 
RelativeLayout 布局 提供 了 一 些 常 用 的 布局 设置 属性 用 于 确定 组 件 在 视图 中 的 相对 位 置 。 相 关 
属性 及 其 所 代表 的 含义 列举 在 表 4.1 中 。 
表 4.1 RelativeLayout 布局 常用 属性 
属性 描述 
将 该 组 件 的 底部 置 于 给 定 ID 的 组 件 之 上 
将 该 组 件 的 底部 置 于 给 定 ID 的 组 件 之 下 
将 该 组 件 的 右边 缘 与 给 定 ID 的 组 件 左 边缘 对 齐 
将 该 组 件 的 左边 缘 与 给 定 ID 的 组 件 右边 缘 对 齐 
将 该 组 件 的 底 边 与 给 定 JD 的 组 件 底 边 对 齐 
将 该 组 件 的 baseline 55455£ ID 的 baseline 对 齐 
将 该 组 件 的 项 部 边缘 与 给 定 症 的 项 部 边缘 对 齐 
将 该 组 件 的 底部 边缘 与 给 定 的 底部 边缘 对 齐 
将 该 组 件 的 左边 缘 与 给 定 的 左边 缘 对 齐 
将 该 组 件 的 右边 缘 与 给 定 ID 的 右边 缘 对 齐 
为 tue， 将 该 组 件 的 顶部 与 其 父 组 件 的 顶部 对 齐 
为 tme， 将 该 组 件 的 底部 与 其 父 组 件 的 底部 对 齐 





android:layout_above 





android:layout below 
android:layout toLeftOf 
android:layout toRightOf 
android:layout alignBottom 
android:layout alignBaseline 
android:layout alignTop 
android:layout alignBottom 
android:layout alignLeft 
android:layout alignRight 
android:layout alignParentTop 
android:layout_alignParentBottom 
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( 续 表 ) 





属性 





android:layout_alignParentLeft 


将 该 组 件 的 左 侧 与 其 父 组 件 的 左 侧 对 齐 








android:layout_alignParentRight 
android:layout_centerHorizontal 
android:layout_centerVertical 


android:layout centerInParent 





将 该 组 件 的 右 侧 与 其 父 组 件 的 右 侧 对 齐 
将 该 组 件 置 于 水 平 居 
HVAT 3E BUR 
将 该 组 件 置 于 父 组 件 的 中 央 


H 


H 











E RelativeLayou 


RelativeLayout #8 


确定 





图 4.7 RelativeLayout 布局 效果 


实例 RelativeLayoutDemo 中 的 布局 文件 main.xml 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 

<RelativeLayout xmlns:android="http://schemas. android. com/apk/res/android" 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
android="http: //schemas. android. com/apk/res/android"> 


<TextView 
android: id="@+id/label" 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android:text="@string/hello”" /> 


<EditText 
android: id="@+id/enter" 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android: layout_alignParentLeft="true" 
android: layout_below="@+id/label" /> 


<Button 
android: id="@+id/button1" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android: layout_alignParentRight="true” 
android: layout_below="@+id/enter” 
android:text="@string/butltext" /> 
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<Button 
android: id="@+id/ok" 
android: layout width-"wrap content" 


android: layout_height="wrap content" 
android: layout_alignBottom="@+id/button1" 
android: layout_alignParentLeft="true" 
android:text="@string/but2text" /> 


</RelativeLayout> 





i; RelativeLayout 布局 的 过 程 如 下 : 


C2710) 放置 一 个 ID A label 的 TextView 组 件 。 

©2702 通过 android:layout below="(@+id/label" 属 性 将 ID A enter 的 组 件 EditText 放置 到 
TextView 的 下 面 。 

G23 在 布局 中 加 入 一 个 ID A button! 的 Button， 通 过 android:layout_below="@+ id/enter" 
属性 将 该 Button 放置 到 enter 的 下 面 , 通过 android:layout_alignParentRight= "tue" BLE Button 放置 
到 相对 布局 的 右 侧 。 

CX304 在 相对 布局 中 加 入 一 个 名 为 ok 的 Button， 通 过 android:layout alignBottom="@+ 
id/button1" 属 性 将 该 Button 底 边 与 button! 对 齐 , 通过 android:layout_alignParentLeft "rue" RTEZ 
Button 放置 到 布局 的 左边 。 


P TableLayoutD: 


4.3.4 TableLayout 


TableLayout 又 称 为 表格 布局 ， 以 行列 的 方式 管理 组 件 。 
TableLayout 布局 没有 边框 ， 可 以 由 多 个 TableRow 对 象 或 者 其 fale a 
他 组 件 组 成 ， 每 个 TableRow 可 以 由 多 个 单元 格 组 成 ,每 个 单元 lll lait 
格 是 一 个 View。TableRow 不 需要 设置 宽度 layout_width 和 高 度 
layout height ,其 宽度 一 定 是 match. parent, 即 自动 填 满 父 容器 ， 
高 度 一 定 为 wrap_content， 即 根据 内 容 改 变 高 度 。 但 对 于 
TableRow 中 的 其 他 组 件 来 说 ， 是 可 以 设置 宽度 和 高 度 的 ， 只 是 
必须 是 wrap_content 或 者 fill parent. 

实例 TableLayoutDemo 演示 了 使 用 TableLayout 制作 UI 的 
方法 ， 效 果 如 图 4.8 所 示 。 

实例 TableLayoutDemo 中 strings.xml 的 代码 如 下 : 图 4.8 TableLayout 布局 效果 

<?xml version="1.0" encoding="utf-8"?> 

<resources> 

<string name="hello">Hello World, TableLayout!</string> 
<string name="app name">TableLayoutDemo</string> 
«string name="column1"> 第 一 行 第 一 列 </string> 
<string name="column2"> 第 一 行 第 二 列 </string> 
<string name="column3"> 第 一 行 第 三 列 </string> 
«string name="empty"> 最 左面 的 可 伸缩 TextView</string> 


<string name="row2column2"> 第 二 行 第 三 列 </string> 


<string name="row2column3">End</string> 
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«string name="merger"> 合 并 三 个 单元 格 </string> 


</resources> 


实例 TableLayoutDemo 中 的 布局 文件 main.xml 的 代码 如 下 : 


<?xml version-"1.0" encoding="utf-8"?> 
<TableLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: layout_width="fill parent" 
android:layout_height="fill parent" > 
<TableRow> 
<TextView 
android:text="@string/columnl" /> 
<TextView 
android:text="@string/column2" /> 
<TextView 
android: text="@string/column3" /> 
</TableRow> 


<TextView 
android: layout_height="wrap content" 
android:background="#fff000" 
android:text-"4444/)— f. Text View" 
android:gravity-"center"/» 
<TableRow> 
<Button 
android: text="@string/merger" 
android: layout_span="3" 
android:gravity="center horizontal” 
android: textColor="#f00" 
/> 
</TableRow> 


<TextView 
android: layout_height="wrap content" 
android: background="#fa05" 
android: text="#HN—f TextView"/> 
<TableRow android: layout_height="wrap content"> 
<TextView 
android:text="@string/empty" /> 
<Button 
android: text="@string/row2Zcolumn2" /> 
<Button 
android: text="@string/row2column3" /> 
</TableRow> 
</TableLayout> 


布局 文件 main.xml 在 TableLayout 布局 内 添加 了 两 个 TableRow 和 两 个 TextView, 形成 了 如 图 
4.8 所 示 的 效果 。 从 运行 效果 看 ,第 一 行 和 第 五 行 都 没 能 完全 显示 。TableLayout 布局 提供 了 几 个 特 
殊 属性 ， 可 以 实现 以 下 特殊 效果 。 
* android:shrinkColumns 属性 : 该 属性 用 于 设置 可 收缩 的 列 。 当 可 收缩 的 列 太 宽 以 至 于 布局 内 
的 其 他 列 不 能 完全 显示 时 ， 可 收缩 列 会 纵向 延伸 ， 压 缩 自己 所 占 的 空间 ， 以 便于 其 他 列 可 以 
完全 显示 出 来 。android:shrinkColumns=“1” 表 示 将 第 2 列 设 置 为 可 收缩 列 ， 列 数 从 0 开始 。 
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* android:stretchColumns 属性 : 该 属性 用 于 设置 可 伸展 的 列 。 可 伸展 的 列 会 自动 扩展 长 度 以 填 
满 所 有 可 用 空间 。android:stretchColumms“1” 表 示 将 第 2 列 设置 为 可 伸展 的 列 。 

* android:collapseColumns 属性 : 该 属性 用 于 设置 隐藏 列 。android:collapseColumns=“1” 表 示 将 
第 2 列 隐藏 不 显示 。 





在 <TableLayout> 标 签 添加 属性 android:shrinkColumns="0"， 再 次 运行 ， 效 果 如 图 4.9 所 示 ， 可 
以 看 出 第 一 行 和 第 五 行 都 完全 显示 出 来 了 。 








图 4.9 完全 显示 的 效果 


4.3.5 AbsoluteLayout 


AbsoluteLayout 又 称 绝对 布局 , 放 入 该 布局 的 组 件 需 要 通过 android:layout_x 和 android:layout_y 
两 个 属性 指定 其 准确 的 坐标 值 ， 并 显示 在 屏幕 上 。 理 论 上 ，AbsoluteLayout 布局 可 用 以 完成 任何 的 
布局 设计 ， 灵活 性 很 大 , 但 是 在 实际 的 工程 应 用 中 不 提倡 使 用 这 种 布局 。 因 为 使 用 这 种 布局 不 但 需 
要 精确 计算 每 个 组 件 的 大 小 , 增 大 运算 量 , 而 且 当 应 用 程序 在 不 同 屏幕 尺寸 的 手机 上 运行 时 会 产生 
不 同 效果 。 

实例 AbsoluteLayoutDemo 演示 了 AbsoluteLayout 布局 的 使 用 方法 ， 效 果 如 图 4.10 所 示 。 


[| AbsoluteLayoutDemo 





图 4.10  AbsoluteLayout 布局 效果 
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实例 AbsoluteLayoutDemo 的 布局 文件 main.xml 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<AbsoluteLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: layout_width="fill parent" 
android: layout_height="fill_parent"> 


<TextView 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android: layout_x="10px" 
android: layout_y="10px" 
android: text="@string/hello"> 
</TextView> 


<TextView 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android: layout_x="80px" 
android: layout_y="80px" 
android:text="@string/action"> 
</TextView> 


<TextView 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android: layout_x="150px" 
android: layout_y="150px" 
android: text="@string/hello"> 
</TextView> 


</AbsoluteLayout> 


其 中 : 


android: layout_x="80px" 
android: layout_y="80px" 

表示 将 组 件 放置 到 以 屏幕 左上 角 为 坐标 原点 的 坐标 系 下 ，x 值 为 80 像素 、y 值 为 80 像素 的 位 置 。 

在 这 里 简单 介绍 一 下 Android 系统 常用 的 尺寸 类 型 的 单位 。 
像素 : 缩写 为 px。 表示 屏幕 上 的 物理 像素 。 
Hh: points， 缩 写 为 pt，1pt 等 于 1 英寸 的 1/72， 常 用 于 印刷 业 。 
KARE: sp. 主要 用 于 字体 的 显示 ，Android 默认 使 用 sp 作为 字号 单位 。 
密度 独立 像素 : 缩写 为 dip 或 dp。 该 尺寸 使 用 160dp 的 屏幕 作为 参考 ， 然 后 用 该 屏幕 映射 到 
实际 屏幕 ， 在 不 同 分 辨 率 的 屏幕 上 会 有 相应 的 缩放 效果 以 适用 于 不 同 分 辨 率 的 屏幕 。 若 用 px 
的 话 ，320px 占 满 HVGA 的 宽度 ， 到 WVGA 上 就 只 能 占 一 半 不 到 的 屏幕 了 ， 那 一 定 不 是 你 
想 要 的 。 


e 毫米 : mn. 
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4.3.6 WebView 








地 








WebView 组 件 是 AbsoluteLayonut 的 子 类 ， 用 于 显示 Web 页 面 。 借 助 于 WebView， 可 以 方便 
发 自己 的 网 络 浏览 器 。 此 处 仅 对 WebView 的 基本 用 法 进行 介绍 , 在 后 面 进行 Web App 的 学 习 


时 会 有 更 进一步 的 讲解 。 


创建 工程 WebViewDemo， 为 其 在 AndroidManifest.xml 文件 中 添加 Internet 访问 权限 : 


<uses-permission android:name-"android.permission.INTERNET" /> 


在 布局 文件 main.xml 中 添加 一 个 WebView 组 件 。Main.xml 内 容 如 下 : 


<?xml version-"1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas. android. com/apk/res/android" 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
android: orientation="vertical"> 


<WebView 
android: id="@+id/webView1" 
android: layout_width="match parent" 
android: layout_height="match parent" /> 


</LinearLayout> 


实例 WebViewDemo 中 的 Activity 文件 WebViewDemoActivity.java 代码 如 下 : 


package introduction.android.webView; 


import android.app.Activity; 
import android.os.Bundle; 
import android.webkit.WebView; 


public class WebViewDemoActivity extends Activity ( 
private WebView webView; 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
webView- (WebView) findViewById (R.id.webViewl) ; 
webView.getSettings().setJavaScriptEnabled (true) ; 
webView.loadUrl ("http://www.google.com") ; 


} 


运行 效果 如 图 4.11 所 示 。 
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Google.com hk 使 用 下 列 语言 





图 4.11 WebViewDemo 运行 界面 


44 ”常用 Widget 组 件 


如 按钮 、 文 本 框 等 。 在 这 一 节 中 着 重 讲解 Android 用 户 UI 设计 中 常用 的 各 种 组 件 的 用 法 。 
Android SDK 提供 了 名 为 android.widget 的 包 ， 其 中 提供 了 在 应 用 程序 界面 设计 中 大 部 分 常用 

的 UI 可 视 组 件 。 之 前 章节 中 涉及 的 各 种 布局 以 及 文本 框 、 按 钮 等 组 件 都 包含 在 这 个 包 中 。Android 

提供 了 强大 的 用 户 UI 功能, 要 设计 自己 独特 的 应 用 程序 界面 , 需要 对 各 个 组 件 有 一 个 详细 的 了 解 。 


4.4.1 创建 Widget 组 件 实例 


在 Android Studio 中 创建 一 个 新 的 工程 , AFA WidgetDemo, 用 于 对 各 种 常见 UI 组 件 进行 学 
习 。 下 面 是 工程 实现 的 步骤 ， 在 后 续 的 章节 中 不 会 再 装 述 该 过 程 。 

ED 新 建 项 目 。 单 击 File | New | New Project， 打 开 New Android Project 对 话 框 ， 如 图 
4.12 所 示 。 

CX302 输入 工程 名 称 WidgetDemo， 在 Location 后 的 文本 框 中 输入 工程 的 保存 路 径 ， 单 击 
Next 按钮 后 ， 选 择 API24:Android 7.0， 再 次 单 击 Next 按钮 。 

€I 选择 EmptyActivity， 确 定 Activity 名 字 和 Layout 文件 的 名 字 ， 单 击 Finish 按钮 ， 则 AS 
会 生成 工程 目录 和 相关 文件 若 需 要 向 以 前 版 本 兼容 , 则 勾 选 "Backwards Compatibility(AppCompat)" 
复 选 框 即 可 。 本 书 中 默认 不 勾 选 。 
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EZE = | 
图 4.12 新 建 项 目 


WidgetDemoActivity.java 文件 是 当前 应 用 程序 的 入 口 类 WidgetDemoActivity 的 定义 文件 。 双 
it WidgetDemoActivity.java， 发 现 已 经 为 其 生成 代码 如 下 : 


package introduction.android.widgetDemo; 
import android.app.Activity; 
import android.os.Bundle; 
public class WidgetDemoActivity extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


) 


其 中 ，onCreate0 方 法 中 的 setContentView (R.layout.main) 表明 WidgetDemoActivity 使 用 的 用 
户 界面 UI 文件 为 main.xml. 
双击 main.xml 文件 , 发 现 提供 了 “Graphical Layout "fI main.xml ”两 种 浏览 方式 。 其 中 "Graphical 
Layonut ”方式 为 以 图 形 方式 浏览 main.xml 文件 ， 其 效果 等 同 于 main.xml 在 手机 设备 上 运行 的 效果 ; 
“main.xml” 方 式 为 以 代码 方式 浏览 main xml 文件 。 这 两 种 方式 是 等 效 的 ， 都 可 以 对 main.xml X 
件 进行 编辑 和 查看 。 单 击 “main.xml” 标 签 ， 发 现 已 经 为 其 生成 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas. android. com/apk/res/android" 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
android:orientation="vertical"> 
<TextView 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android:text="@string/hello" /> 
</LinearLayout> 


该 文件 表明 ， 当 前 main.xml 文件 所 使 用 的 布局 为 LinearLayout 布局 ， 该 布局 自动 填 满 整个 手 
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机 屏幕 。 在 该 布局 中 ， 放 置 了 一 个 TextView Att, iz TextView 显示 的 内 容 为 "@string/hello"， 表 
示 string.xml 文件 中 定义 的 hello 变量 的 内 容 。 双 击 values 目录 下 的 string.xml 文件 ， 会 发 现 hello 
变量 对 应 的 值 为 “Hello World, WidgetDemoActivity!" o 

单 击 main xml 的 “Graphical Layout” 浏 览 方式 ， 可 查看 当前 文件 的 图 形 化 效果 ， 如 图 4.13 所 示 。 


Palette Ge IH 
Widgets 

[FE] TextView 

GK Button 








= ToggleButton 
[|] CheckBox 
@ RadioButton 
Fe CheckedTextView 
= Spinner 
=æ ProgressBar (Large) 
= ProgressBar 
== ProgressBar (Small) 
= ProgressBar (Horizontal) 
*9* SeekBar 
"ev SeekBar (Discrete) 
1= QuickContactBadge 
* RatingBar 
"n Switch 

EiSpace 

D Text Fields (EditText) 
加 plain Text 
M Password 


图 4.13 文件 的 图 形 化 效果 
程序 开发 人 员 可 以 在 该 图 形 方式 下 将 左 侧 的 各 种 组 件 直 接 拖 外 到 屏幕 上 ， 形 成 自己 想 要 的 布 
局 ， 也 可 以 直接 修改 main.xml 文件 的 代码 。 
在 后 续 章节 中 ， 在 对 布局 文件 进行 修改 时 ， 若 非特 殊 情 况 ， 将 不 再 单独 描述 。 








44.2 ”按钮 


按钮 《Button) 应 该 是 用 户 交互 中 使 用 最 多 的 组 件 ， 在 很 多 应 用 程序 中 都 很 常见 。 当 用 户 单 击 
按钮 的 时 候 ， 会 有 相对 应 的 响应 动作 。 下 面 在 WidgetDemo 工程 的 主 界面 main.xml 中 放置 一 个 名 
为 Button 的 按钮 。 文 件 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
<LinearLayout xmlns:android="http://schemas. android. com/apk/res/android" 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
android: orientation="vertical"> 
<TextView 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android: text="@string/hello" /> 


<Button 
android: id="@+id/button1" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android:text-"Button" /> 


74 | Android 7 应 用 程序 开发 教程 





</LinearLayout> 


其 中 : 


<Button 
android:id="@+id/button1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Button" /» 


表明 在 用 户 界面 上 放置 了 一 个 ID 为 “button1” 的 按钮 ， 按 钮 的 高 度 〈layout height) 和 宽度 
(layout width) 都 会 根据 实际 内 容 调整 (wrap_content) ， 按 钮 上 显示 文字 为 Button， 其 运行 效果 
如 图 4.14 所 示 。 


ello World, Widget 





图 4.14 Button 的 应 用 界面 


按钮 最 重要 的 用 户 交 互 事件 是 “ 单 击 ”事件 。 下 面 为 Button! ; 
件 。 该 过 程 在 WidgetDemoActivity.java 文件 中 完成 ， 代 码 如 下 : 





加 事件 监听 器 和 相应 的 单 击 事 


package introduction.android.widgetDemo; 


import android.app.Activity; 

import android.os.Bundle; 

import android.util.Log; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 


public class WidgetDemoActivity extends Activity { 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
Button btn- (Button) this.findViewById (R.id.buttonl) ; 
btn.setOnClickListener (new OnClickListener()( 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
setTitle ("buttonl 被 用 户 点 击 了 ") ; 
Log.i ("widgetDemo", "buttonl 被 用 户 点击 了 。") ; 


Ds 
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i 

在 WidgetDemoActivity 的 onCreate() 方 法 中 , 通过 findViewById(R.id.button1 ) 方 法 获得 Button1 
的 对 象 , 通过 setOnClickListener0 方 法 为 Buttonl 设置 监听 器 。 此 处 新 建 了 一 个 实现 OnClickListener 
接口 的 匿名 类 作为 监听 器 ， 并 实现 了 onClick( 方 法 。 当 Button] 被 点 击 时 ， 当 前 应 用 程序 的 标题 被 
设置 成 “buttonl 被 用 户 点 击 了 ”， 对 应 在 LogCat 中 也 会 打印 相应 的 字符 串 ， 运 行 结 果 如 图 4.15 
所 示 。 




















| button 被 用 户 点 击 了 


Hello World, WidgetDemoActivity! 


Button 


widgetDemo buttonl RAP SET. 


图 4.15 点 击 按钮 运行 效果 





44.3 ”文本 框 


文本 框 (TextView) 是 用 于 在 界面 上 显示 文字 的 组 件 ， 其 显示 的 文本 不 可 被 用 户 直接 编辑 。 
程序 开发 人 员 可 以 设置 TextView 的 字体 大 小 、 颜 色 、 样 式 等 属性 。 在 工程 WidgetDemo 的 main.xml 
中 添加 一 个 TextView， 代 码 如 下 : 


<TextView 
android: id="@+id/textViewl” 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android:text-"TextView" /> 


运行 效果 如 图 4.16 所 示 。 


[a WidgetDemo 


Hello World, WidgetDemoActivity! 


Button 


TextView 





图 4.16 TextView 的 应 用 界面 
修改 Button] 的 单 击 事件 为 : 


public void onClick (View view) { 
// TODO Auto-generated method stub 
//setTitle ("buttonl RAP HHT") ; 
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Log.i ("widgetDemo", "buttonl 被 用 户 单 击 了 。") ; 

TextView textview- (TextView) findViewById (R.id.textViewl) ; 
textview.setText ("设置 TextView 的 字体 ") ; 
textview.setTextColor (Color.RED) ; 
textview.setTextSize (TypedValue.COMPLEX UNIT SP, 20) ; 

textview.setTypeface (Typeface.defaultFromStyle (Typeface.BOLD)) ; 

} 


“4 Button] 被 单 击 时 , 通过 setText() 77 12:38 Pt textView 的 显示 内 容 为 “设置 TextView 的 字体 ”， 
通过 setTextColor0 方 法 修改 textView 显示 字体 的 颜色 为 红色 , 通过 setTextSize( 方 法 修改 textView 
显示 字体 的 大 小 为 20sp， 通 过 setTypeface( 方 法 修改 textView 显示 字体 的 风格 为 加 粗 ， 如 图 4.17 
所 示 。 





BB widgetpemo 


Hello World, WidgetDemoActivity! 


Button 





图 4.17 单 击 按钮 运行 效果 


当然 , 该 过 程 也 可 以 通过 修改 main.xml 文件 来 实现 。 将 TextView 标签 按照 如 下 代码 修改 也 可 
以 得 到 同样 的 效果 ， 但 是 失去 了 应 用 程序 中 与 用 户 交 互 的 过 程 : 
<TextView 
android: id="@t+id/textViewl" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android: text="KM TextView MFA" 
android: textColor="#ff0000" 
android: textSize="20sp" 
android: textStyle="bold"/> 


444 编辑 杠 


编辑 框 (EditText) 是 TextView 的 子 类 ， 在 TextView 的 基础 上 增加 了 文本 编辑 功能 ， 用 于 处 
理 用 户 输入 ， 例 如 登录 框 等 ， 是 非常 常用 的 组 件 。 

在 工程 WidgetDemo 的 main.xml 文件 中 添加 一 个 EditText， 并 实现 这 个 功能 : 用 户 在 EditText 
中 输入 信息 的 同时 ， 用 一 个 TextView 显示 用 户 输入 的 信息 。 

工程 WidgetDemo 中 的 布局 文件 main.xml 中 增加 的 代码 如 下 : 


<EditText 
android: id="@+id/editText1" 
android: layout_width="match parent" 
android: layout_height="wrap_content"> 


在 WidgetDemoActivity 的 onCreate0 方 法 中 添加 下 列 代码 : 
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editText- (EditText) findViewById (R.id.editText1) ; 
editText.addTextChangedListener (new TextWatcher() { 


@override 
public void afterTextChanged (Editable s) { 
// TODO Auto-generated method stub 


H 


@Override 

public void beforeTextChanged (CharSequence s, int start, int count, 
int after) { 
// TODO Auto-generated method stub 


) 


@Override 
public void onTextChanged (CharSequence s, int start, int before, 
int count) { 
// TODO Auto-generated method stub 
String text-editText.getText () .toString(); 
textview.setText (text) ; 


De 


运行 结果 如 图 4.18 所 示 。 


| widgetpemo 
Hello World, WidgetDemoActivity! 


Button 


abcdefd 





图 4.18 EditText 的 应 用 界面 


4.4.5 多 项 选择 按钮 


多 项 选择 按钮 (CheckBox) 属于 输入 型 组 件 ， 该 组 件 允许 用 户 一 次 选择 多 个 选项 。 当 用 户 不 





方便 在 手机 屏幕 上 直接 进行 输入 操作 时 ， 该 组 件 的 使 用 显得 尤为 方便 。 
下 面 通 过 实例 讲解 CheckBox 的 使 用 方法 。 该 实例 的 运行 效果 如 图 4.19 所 示 。 
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P WidgetDemo 
你 的 爱好 是 :篮球 听 歌 曲 看 书 
篮球 


听 歌 曲 
看 书 





图 4.19 CheckBox 的 应 用 界面 
在 工程 WidgetDemo 的 布局 文件 main.xml 文件 中 添加 一 个 Button， 代 码 如 下 : 


<Button 
android: id="@t+id/button2" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android: text="CheckBoxDemo" /> 


“4i% Button 被 用 户 单 击 时 ， 启 动 一 个 名 为 CheckBoxActivity 的 Activity, #1% Activity 中 演示 
CheckBox 的 使 用 方法 。 启 动 CheckBoxActivity 的 相关 代码 如 下 : 


Button ckbtn= (Button) this.findViewById (R.id.button2) ; 
ckbtn.setOnClickListener (new OnClickListener () { 


@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
Intent intent-new Intent (WidgetDemoActivity.this, CheckBoxActivity.class) ; 
startActivity (intent) ; 
T 
Ds 


同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 


<activity android:name="CheckBoxActivity"></activity> 





CheckBoxActivity 所 使 用 的 布局 文件 为 checkbox.xml， 使 用 LinearLayout 布局 ， 其 中 放置 了 一 
个 TextView 和 三 个 CheckBox。Checkbox.xml 的 文件 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas. android. com/apk/res/android" 





android: layout_width="match parent" 
android: layout_height="match parent" 


android:orientation-"vertical"» 
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<TextView 
android: id="@tid/text” 
android: layout_width="fill parent" 
android: layout height-"wrap content" 
android:text="@string/checkboxhello"/> 
<CheckBox 
android: id="@+id/CheckBox1” 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android:text="@string/football"/> 
<CheckBox 
android: id="@+id/CheckBox2" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android: text="@string/song"/> 
<CheckBox 
android: id="@tid/CheckBox3" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android:text="@string/book"/> 


</LinearLayout> 
这 4 个 组 件 在 对 应 的 strings.xml 文件 中 定义 的 变量 为 : 
«string name="checkboxhe11o"> 你 的 爱好 是 :</string> 
«string name="football"> 篮 球 </string> 
<string name="song"> 听 歌曲 </string> 
«string name="book"> 看 书 </string> 
当 用 户 对 多 项 选择 按钮 进行 选择 时 ， 为 了 确定 用 户 选择 的 是 哪 几 项 ， 需 要 对 每 个 多 项 选择 按 
钮 进行 监听 。CompoundButton.OnCheckedChangedListener 接口 可 用 于 对 CheckBox 的 状态 进行 监听 。 
当 CheckBox 的 状态 在 未 被 选中 和 被 选中 之 间 变化 时 ， 该 接口 的 onCheckedChanged0 方 法 会 被 系统 调 
用 。CheckBox 通过 setOnCheckedChangeListener() 方 法 将 该 接口 对 象 设 置 为 自己 的 监听 器 。 
CheckBoxActivity java 的 代码 如 下 : 





package introduction.android.widgetDemo; 


import android.app.Activity; 

import android.os.Bundle; 

import android.widget.CheckBox; 
import android.widget.CompoundButton; 
import android.widget.TextView; 


public class CheckBoxActivity extends Activity { 
private TextView textView; 
private CheckBox bookCheckBox; 
private CheckBox songCheckBox; 
private CheckBox footbaCheckBox; 
@Override 
protected void onCreate (Bundle savedInstanceState) { 
// TODO Auto-generated method stub 


super.onCreate (savedInstanceState) ; 
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this.setContentView (R.layout.checkbox) ; 
textView- (TextView) findViewById (R.id.text) ; 
footbaCheckBox= (CheckBox) findViewById (R.id.CheckBox1) ; 
songCheckBox= (CheckBox) findViewById (R.id.CheckBox2) ; 


bookCheckBox- (CheckBox) findViewById (R.id.CheckBox3) ; 


footbaCheckBox.setOnCheckedChangeListener (new 
CompoundButton.OnCheckedChangeListener () ( 


@Override 
public void onCheckedChanged (CompoundButton buttonView, boolean isChecked) { 


// TODO Auto-generated method stub 
if (footbaCheckBox.isChecked()) { 
textView.append (footbaCheckBox.getText().toString()) ; 


jelse { 
if (textView.getText().toString().contains ("足球 ")) { 


textView.setText (textView.getText().toString().replace (" 足 球 "， 
} 





} 
D: 
songCheckBox.setOnCheckedChangeListener (new 


CompoundButton.OnCheckedChangeListener () ( 


GOverride 
public void onCheckedChanged (CompoundButton buttonView, boolean isChecked) ( 


// TODO Auto-generated method stub 
if (songCheckBox.isChecked()) ( 
textView.append (songCheckBox.getText().toString()) + 


jelse { 
if (textView.getText().toString().contains ("唱歌 ")) { 
textView.setText (textView.getText().toString().replace (" 唱 歌 "，"")) ; 


) 


bookCheckBox.setOnCheckedChangeListener (new 
CompoundButton.OnCheckedChangeListener () ( 


@Override 
public void onCheckedChanged (CompoundButton buttonView, boolean isChecked) { 


// TODO Auto-generated method stub 


if (bookCheckBox.isChecked()) { 
textView.append (bookCheckBox.getText ().toString()) ; 


jelse { 
if (textView.getText().toString().contains ("读书 ")) { 


textView.setText (textView.getText().toString().replace (" 读 书 "，"")) ; 
H 
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CheckBoxActivity 为 Checkbox.xml 文件 中 的 三 个 CheckBox 分 别 添加 了 监听 器 。 当 CheckBox 
的 状态 发 生 改变 时 ， 通 过 Checkbox.isChecked() 方 法 可 以 获取 当前 CheckBox 按钮 的 选中 状态 ， 进 
而 进行 处 理 。 


4.4.6 单项 选择 按钮 组 


RadioGroup 为 单项 选择 按钮 组 ， 其 中 可 以 包含 多 个 RadioButton， 即 单 选 按钮 ， 它 们 共同 为 用 
户 提供 一 种 多 选 一 的 选择 方式 。 在 多 个 RadioButton 被 同一 个 RadioGroup 包含 的 情况 下 ， 多 个 
RadioButton 之 间 自 动 形成 互 斥 关 系 ， 仅 有 一 个 可 以 被 选择 。 单 选 按钮 的 使 用 方法 和 CheckBox 的 使 
用 方法 高 度 相 似 ， 其 事件 监听 接口 使 用 的 是 RadioGroup.OnCheckedChangeListener() ， 使 用 
setOnCheckedChangeListener() 方 法 将 监听 器 设置 到 单 选 按钮 上 。 按 照 CheckBox 的 讲解 思路 ， 启 动 
一 个 名 为 RadioGroupActivity 的 Activity 来 对 RadioGroup 进行 讲解 。 

RadioGroupActivity 的 运行 效果 如 图 4.20 所 示 。 
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ETIE 
足球 


篮球 





图 4.20  RadioGroup 的 应 用 界面 


在 工程 WidgetDemo 的 布局 文件 main.xml 中 添加 一 个 Button, 并 启动 RadioGroupActivity 的 相 
关 代码 。 在 main.xml 中 添加 代码 如 下 : 
<Button 
android:id="@+id/button3" 
android:layout_width="wrap content" 
android:layout_height="wrap content" 
android:text="RadioGroupDemo" /> 


启动 处 理 RadioGroup 的 Activity RadioGroupActivity 的 代码 如 下 : 


Button radiotn- (Button) this.findViewById (R.id.button3) ; 
radiotn.setOnClickListener (new OnClickListener() { 


@Override 
public void onClick (View v) { 


82 | Android 7 应 用 程序 开发 教程 





// TODO Auto-generated method stub 
Intent intent=new Intent (WidgetDemoActivity.this, RadioGroupActivity.class) ; 
startActivity (intent) ; 


ps 

同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 
<activity android:name-" RadioGroupActivity "></activity> 
RadioGroupActivity 使 用 的 是 radiogroup xml， 其 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:orientation-"vertical"» 


<TextView 
android: id="@t+id/radiohello” 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android:text="@string/hello"/> 


<RadioGroup 
android: id="@+tid/radiogroup1" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android:orientation-"vertical" 
android:layout x-"3px" 


<RadioButton 
android: id="@+id/radiobuttonl" 
androi 





layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"éstring/football" 
/> 
<RadioButton 
android: id="@+id/radiobutton2" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android: text="@string/bascketball" 
/> 
<RadioButton 
android: id="@+id/radiobutton3" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android: text="@string/badminton" 
/> 
</RadioGroup> 


</LinearLayout> 


该 布局 文件 使 用 了 LinearLayout 布局 ， 并 且 在 其 中 放置 了 一 个 TextView 和 一 个 RadioGroup. 
RadioGroup 中 含有 三 个 RadioButton。 这 些 组 件 对 应 的 strings.xml 文件 中 定义 的 变量 为 : 
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«string name="radiohel11o"> 你 最 喜欢 的 运动 是 :</string> 
«string name="bascketball1"> 篮 球 </string> 
«string name="badminton"> 羽 毛 球 </string> 

«string name="football1"> 足 球 </string> 


RadioGroupActivity java 的 代码 如 下 : 


package introduction.android.widgetDemo; 


import android.app.Activity; 
import android.os.Bundle; 

import android.widget.RadioButton; 
import android.widget.RadioGroup; 
import android.widget.TextView; 


public class RadioGroupActivity extends Activity ( 

private TextView textview; 

private RadioGroup radiogroup; 

private RadioButton radiol,radio2,radio3; 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.radiogroup) ; 
textview= (TextView) findViewById (R.id.radiohello) ; 
radiogroup- (RadioGroup) findViewById (R.id.radiogroupl) ; 
radiol- (RadioButton) findViewById (R.id.radiobuttonl) ; 
radio2- (RadioButton) findViewById (R.id.radiobutton2) ; 
radio3- (RadioButton) findViewById (R.id.radiobutton3) ; 
radiogroup.setOnCheckedChangeListener (new RadioGroup.OnCheckedChangeListener () { 


@Override 
public void onCheckedChanged (RadioGroup group, int checkedId) 
{ 
// TODO Auto-generated method stub 
String text=" 我 最 喜欢 的 运动 是 "; 
if (checkedId==radiol.getId()) { 
texti-radiol.getText().toString(); 
textview.setText (text) ; 
Jelse if (checkedId==radio2.getId()) ( 
texti-radio2.getText().toString(): 
textview.setText (text) ; 
}else if (checkedId==radio3.getId()) ( 
text+=radio3.getText () .toString(); 
textview.setText (text) ; 


Ds 


在 RadioGroupActivity 的 onCreate() 7; iX rP 7j RadioGroup 添加 监视 器 RadioGroup o 
OnCheckedChangeListener 在 其 回调 方法 onCheckedChanged()' Xt = RadioButton 分 别 进行 处 理 。 
需要 说 明 的 是 ， 如 果 把 RadioGroup 去 掉 ， 只 使 用 RadioButton 的 话 ， 则 需要 为 每 个 RadioButton 单 
独 设置 监听 器 ， 其 使 用 方法 和 CheckBox 没有 任何 区 别 。 
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447 “下拉 列表 


Spinner 提供 下 拉 列 表 式 的 输入 方式 ， 该 方法 可 以 有 效 节省 手机 屏幕 上 的 显示 空间 。 

下 面 用 一 个 简单 的 实例 讲解 Spinner 的 使 用 方法 。 在 工程 WidgetDemo 的 布局 文件 main.xml 
中 添加 一 个 Button， 用 以 启动 SpinnerActivity。 

在 main.xml 中 添加 代码 如 下 : 


<Button 
android: id="@+id/button4" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android: text="SpinnerDemo" /> 


单 击 Button 并 启动 SpinnerActivity 的 代码 如 下 : 


Button spinnerbtn- (Button) this.findViewById (R.id.button4) ; 
spinnerbtn.setOnClickListener (new OnClickListener() { 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
Intent intent=new Intent (WidgetDemoActivity.this, SpinnerActivity.class) ; 
startActivity (intent) ; 
y 
D: 
同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 


<activity android:name=" SpinnerActivity "></activity> 


SpinnerActivity 的 运行 效果 如 图 4.21 所 示 。 
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图 421 Spinner 的 应 用 界面 
SpinnerActivity 使 用 的 布局 文件 为 spinerxml， 其 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
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<LinearLayout xmlns:android="http://schemas. android. com/apk/res/android” 


android: layout_width="match parent" 





android: layout_height="match parent" 
android:orientation="vertical"> 
<TextView 

android: id="@+id/textViewl” 
android: layout width-"wrap content" 
android: layout_height="wrap content" 
android: text="textview"/> 

<Spinner 
android: id="@+id/spinnerl" 
android:layout width-"match parent" 
android:layout height-"wrap content" /» 


</LinearLayout> 


SpinnerActivity java 文件 的 代码 如 下 : 


package introduction.android.widgetDemo; 


import java.util.ArrayList; 

import java.util.List; 

import android.app.Activity; 
import android.os.Bundle; 

import android.view.MotionEvent; 
import android.view.View; 

import android.widget.AdapterView; 
import android.widget.ArrayAdapter; 
import android.widget.Spinner; 
import android.widget.TextView; 


public class SpinnerActivity extends Activity { 

private List<String>list=new ArrayList<String>(); 

private TextView textview; 

private Spinner spinnertext; 

private ArrayAdapter<String>adapter; 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.spiner) ; 
// 第 一 步 : 定义 下 拉 列 表 内 容 
list.add ("沈阳 ") 
list.add ("天 津 ") 
list.add ("AER") ; 
list.add ("上 海 ") 
list.add ("深圳 ") ; 
textview- (TextView) findViewById (R.id.textViewl) ; 
spinnertext- (Spinner) findViewById (R.id.spinnerl) ; 
// 第 二 步 : 为 下 拉 列 表 定 义 一 个 适配器 


adapter-new ArrayAdapter<String> (this, android.R.layout.simple spinner item, 





list) ; 
// 第 三 步 : 设置 下 拉 列 表 下 拉 时 的 菜单 样式 
adapter.setDropDownViewResource 
(android.R.layout.simple spinner dropdown item) ; 
// 第 四 步 : 将 适配器 添加 到 下 拉 列 表 上 


spinnertext.setAdapter (adapter) ; 
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// 第 五 步 : 添加 监听 器 ， 为 下 拉 列 表 设 置 事件 的 响应 
spinnertext.setOnItemSelectedListener (new Spinner.OnItemSelectedListener () { 
public void onItemSelected (AdapterView<?>arg0, View argl, int arg2, long arg3) 


// TODO Auto-generated method stub 
/* 将 所 选 spinnertext 的 值 带 入 myTextView 中 */ 
textview.setText ("我 来 自 : "tadapter.getItem (arg2)) ; 
/* 将 spinnertext 显示 */ 
arg0.setVisibility (View.VISIBLE) ; 
) 
public void onNothingSelected (AdapterView«?»arg0) ( 
// TODO Auto-generated method stub 
textview.setText ("NONE") ; 
arg0.setVisibility (View. VISIBLE) ; 
) 
p: 
// 将 spinnertext 添加 到 OnTouchListener 对 内 容 选项 触 屏 事件 处 理 
spinnertext.setOnTouchListener (new Spinner.OnTouchListener()1{ 
@Override 
public boolean onTouch (View v, MotionEvent event) { 
// TODO Auto-generated method stub 
// i mySpinner 隐藏 
v.setVisibility (View.INVISIBLE) ; 
Log.i ("spinner","Spinner Touch 事件 被 触发 !") ; 
return false; 
) 
We 
// 焦 点 改变 事件 处 理 
spinnertext.setOnFocusChangeListener (new Spinner.OnFocusChangeListener () { 
public void onFocusChange (View v, boolean hasFocus) { 
// TODO Auto-generated method stub 
v.setVisibility (View. VISIBLE) ; 
Log.i ("spinner", "Spinner FocusChange 事件 被 触发 ! ") = 


} 

SpinnerActivity 通过 5 个 步骤 将 Spinner 初始 化 并 进行 事件 处 理 ， 分 别 为 : 

定义 下 拉 列 表 的 列表 项 内 容 List<String>。 

为 下 拉 列 表 Spinner 定义 一 个 适配器 ArrayAdapter<String>， 并 与 列表 项 内 容 相 关联 。 

使 用 ArayAdaptersetDropDownViewResourceO 设 置 Spinner 下 拉 列 表 在 打开 时 的 下 拉 菜 单 样式 。 
使 用 Spinner. setAdapter0 将 适配器 数据 与 Spinner 关联 起 来 。 

为 Spinner 添加 事件 监听 器 ， 进 行事 件 处 理 。 


Spinner 支持 多 种 事件 处 理 方式 ， 本 实例 中 对 Spinner 被 单 击 事件 、 焦 点 改变 事件 和 Spinner 的 
列表 项 被 选中 事件 进行 了 处 理 。 
在 本 实例 中 ，SpinnerActivity 在 程序 代码 中 动态 建立 了 下 拉 列 表 每 一 项 的 内 容 。 除 此 之 外 ， 还 
可 以 在 XML 文件 中 定义 Spinner 的 下 拉 列 表 项 ， 步 骤 如 下 。 
在 res/values 文件 夹 下 新 建 cities.xml 文件 夹 : 
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<?xml version="1.0" encoding-"utf-8"?» 
<resources> 
<string-array name-"city"» | | WidgetDemo 
<item>shenyang</item> 
<item>nanjing</item> arpaning 
<item>beijing</item> 
Seer Raa aise Seen 
</string-array> 
</resources> nanjing 


在 SpinnerActivity java 中 初始 化 Spinner: 


beij 


Spinner spinner- (Spinner) findViewById (R.id.spinnerl) ; 

ArrayAdapter«CharSequence»adapter-ArrayAdapter.createF tianjin 
romResource (this, R.array.city, 
android.R.layout.simple_spinner_item) ; 

adapter. setDropDownViewResource 
(android.R.layout.simple_spinner_dropdown_item) ; 

spinner.setAdapter (adapter) ; 


运行 效果 如 图 4.22 所 示 。 





图 4.22 Spinner 的 事件 处 理 


448 自动 完成 文本 


在 使 用 百度 或 者 Google 搜索 信息 时 ， 只 需要 在 搜索 框 中 输入 几 个 关键 字 ， 就 会 有 很 多 相关 的 
信息 以 列表 形式 被 列举 出 来 供用 户 选择 ， 这 种 效果 在 Android SDK 中 可 以 通过 
AutoCompleteTextView 来 实现 。 

下 面 用 一 个 简单 的 实例 讲解 AutoCompleteTextView 的 使 用 方法 。 在 工 
文件 main.xml 中 添加 一 个 Button， 用 以 启动 AutoCompleteTextViewActivity。 

在 main.xml 中 添加 代码 如 下 : 

<Button 

android: id="@+id/button5" 
android: layout_width="wrap content" 


android: layout_height="wrap content" 
android: text="AutoCompleteTextViewDemo" /> 





t WidgetDemo 的 布局 


单 击 Button 并 启动 AutoCompleteTextViewActivity 的 代码 如 下 : 


Button autobtn- (Button) this.findViewById (R.id.button5) ; 
autobtn.setOnClickListener (new OnClickListener()( 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
Intent intent=new Intent 
(WidgetDemoActivity. this, AutoCompleteTextViewActivity.class) ; 
startActivity (intent) ; 


iL 
同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 


<activity android:name-" AutoCompleteTextViewActivity"></activity> 
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AutoCompleteTextViewActivity 的 运行 效果 如 图 4.23 所 示 。 
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图 4.23  AutoCompleteTextViewActivity 的 运行 效果 


AutoCompleteTextViewActivity 使 用 的 布局 文件 为 autocompletetextview.xml, 其 具体 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas. android. com/apk/res/android" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:orientation-"vertical"» 
<TextView 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android:text-"AutoCompleteTextView Him: " /> 


<AutoCompleteTextView 
android: id="@+id/autoCompleteTextViewl" 
android: layout_width="match parent" 
android: layout_height="wrap content" 
android:text=""> 
<requestFocus /> 
</AutoCompleteTextView> 


</LinearLayout> 


AutoCompleteTextViewActivity java 的 代码 如 下 : 


package introduction.android.widgetDemo; 


import android.app.Activity; 

import android.os.Bundle; 

import android.widget.ArrayAdapter; 

import android.widget.AutoCompleteTextView; 


public class AutoCompleteTextViewActivity extends Activity { 
private AutoCompleteTextView textView; 
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private static final String[] autotext-new String[] {"hello","hello World","hello 
Android"]; 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.autocompletetextview) ; 
textView- (AutoCompleteTextView ) findViewById (R.id.autoCompleteTextViewl) ; 
/*new ArrayAdapterd 对 象 将 autotext 字符 串 数组 传 入 */ 
ArrayAdapter<String>adapter=new ArrayAdapter<String> 
(this, android.R.layout.simple dropdown item lline,autotext) ; 
/*#§ ArrayAdapter 添加 到 AutoCompleteTextView 中 */ 
textView.setAdapter (adapter) ; 


} 


AutoCompleteTextViewActivity 中 为 可 自动 补 全 的 内 容 建 立 对 应 字符 串 数 组 autotext, 将 该 数组 
关联 到 ArrayAdapter 中 ， 然 后 将 ArrayAdapter 与 AutoCompleteTextView 相关 联 ， 进 而 实现 自动 完 
成 文本 功能 。 

AutoCompleteTextView 提供 一 系列 属性 对 显示 效果 进行 设置 ， 分 别 说 明 如 下 。 


© completionThreshold: 它 的 值 决定 了 你 在 AutoCompleteTextView 中 至 少 输入 几 个 字符 ， 才 会 
具有 自动 提示 的 功能 。 另 外 ， 默 认 最 多 提示 20 条 。 

e dropDownAnchor: 它 的 值 是 一 个 View 的 ID, 指定 后 ，AutoCompleteTextView 会 在 这 个 View 
下 弹出 自动 提示 。 

* dropDownSelector: 应 该 是 设置 自动 提示 的 背景 色 之 类 的 ， 没 有 尝试 过 ， 有 待 进一步 考证 。 

© dropDownWidth: 设置 自动 提示 列表 的 宽度 。 


449 “日 期 选择 器 和 时 间 选 择 器 


Android SDK 提供 了 DatePicker 和 TimePicker 组 件 ， 分 别 对 日 期 和 时 间 进 行 选择 ， 方 便 日 期 
和 时 间 设 定 。 

下 面 用 一 个 简单 的 实例 讲解 DatePicker 和 TimePicker 组 件 的 使 用 方法 。 在 工程 WidgetDemo 
的 布局 文件 main.xml 中 添加 一 个 名 为 “Date/Time” 的 Button， 用 以 启动 TimeActivity。 

在 main.xml 中 添加 代码 如 下 : 


<Button 
android: id="@+id/button6" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android:text=" Date/Time " /> 


单 击 Button 并 启动 TimeActivity 的 代码 如 下 : 


Button timebtn- (Button) this.findViewById (R.id.button6) ; 
timebtn.setOnClickListener (new OnClickListener() { 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
Intent intent-new Intent (WidgetDemoActivity.this, TimeActivity.class) ; 





90 | Android 7 应 用 程序 开发 教程 





startActivity (intent) ; 


Ds 
同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 
<activity android:name=" TimeActivity"></activity> 


TimeActivity 的 运行 效果 如 图 4.24 所 示 。 
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图 4.24 TimeActivity 的 运行 效果 


TimeActivity 使 用 的 布局 文件 为 time.xml， 其 内 容 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
<LinearLayout xmlns:android="http://schemas. android. com/apk/res/android" 
android: layout_width="match parent" 
android:layout height-"match parent" 
android:orientation-"vertical"» 
<TextView 
android: id="@+id/timeview" 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android: text="DatePicker Ñ TimePicker zv" /> 
<TimePicker 
android: id="@+id/timepicker" 
android: layout_width="wrap content" 
android: layout_height="116dp" 
android:background="#778888" /> 
<!-- 设置 背景 色 为 墨绿 --> 
<DatePicker 
android: id="@tid/datepicker" 
android: layout_width="27ldp" 
android: layout_height="196dp" 
android: background="#778899" /> 
</LinearLayout> 
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TimeActivity java 的 代码 如 下 : 


package introduction.android.widgetDemo; 


import 


public 


java.util.Calendar; 


android.app.Activity; 
android.os.Bundle; 
android.widget.DatePicker; 
android.widget.TextView; 
android.widget.TimePicker; 


class TimeActivity extends Activity ( 


private TextView textview; 
private TimePicker timepicker; 
private DatePicker datepicker; 
/* 声明 日 期 及 时 间 变量 */ 
Private int year; 
Private int month; 
Private int day; 


Private int hour; 


Private int minute; 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.time) ; 
/* 获取 当前 日 期 及 时 间 */ 
Calendar calendar=Calendar.getInstance(); 
year=calendar.get (Calendar. YEAR) ; 
month-calendar.get (Calendar.MONTH) ; 
day-calendar.get (Calendar.DAY OF MONTH) ; 
hour-calendar.get (Calendar.HOUR) ; 
minute-calendar.get (Calendar.MINUTE) ; 
datepicker- (DatePicker) findViewById (R.id.datepicker) ; 
timepicker- (TimePicker) findViewById (R.id.timepicker) ; 
/* 设置 TextView 对 象 ， 显 示 初 始 日 期 时 间 */ 


textview- (TextView) findViewById (R.id.timeview) ; 


textview.setText (new StringBuilder().append (year) .append ("/") 
-append (format (month+1)) .append ("/") .append (format (day)) 


-append (" ") .append (format (hour)) .append (":") 
-append (format (minute))) ; 


/* I onDateChangedListener () */ 
datepicker.init (year, month, day, 


new DatePicker.OnDateChangedListener () { 
@Override 
public void onDateChanged (DatePicker view, int year, 
int monthOfYear, int dayOfMonth) { 
// TODO Auto-generated method stub 
TimeActivity.this.year-year; 
month-monthOfYear; 
day-dayOfMonth; 
textview.setText (new StringBuilder().append (year) 
-append ("/") .append (format (month+1)) 
-append ("/") .append (format (day)) .append (" ") 
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.append (format (hour)) .append (":") 
-append (format (minute))) ; 
} 
p: 
timepicker.setOnTimeChangedListener (new TimePicker.OnTimeChangedListener () 


{ 


@Override 
public void onTimeChanged (TimePicker view, int hourOfDay, int minute) 
ü 
// TODO Auto-generated method stub 
hour-hourOfDay; 
TimeActivity.this.minute-minute; 
textview.setText (new StringBuilder().append (year) 
-append ("/") .append (format (month+1)) 
.append ("/") .append (format (day)) .append (" ") 
-append (format (hour)) .append (":") 
-append (format (minute))) ; 


ye 


private String format (int time) { 
String str=""+time; 
if (str.length()==1) 
str="0"+strz 
return str; 
} 
} 
TimeActivity 中 使 用 java.util.Calendar 对 象 获 取 当 前 系统 时 间 。 当 更 改 DatePicker 组 件 中 的 日 
期 时 , 会 触发 DatePicker 的 OnDateChange() 事 件 ; 当 修改 TimePacker 的 时 间 时 , 会 触发 TimePacker 
的 OnDateChange() 事 件 。 
由 本 实例 可 见 ，DatePicker 实现 OnDateChangedListener 监听 器 的 方法 与 TimePicker 实现 
setOnTimeChangedListener 监听 器 的 方法 有 所 类 似 。DatePicker 用 init0 方 法 设 定年 、 月 、 日 的 同时 
设 定 监听 器 ， 而 TimePicker 使 用 setOnTimeChangedListener() H Pci © 





4.4.10 进度 条 


当 应 用 程序 在 后 台 运 行 时 ， 可 以 使 用 进度 条 (ProgressBar) 反馈 给 用 户 当 前 的 进度 信息 。 进 度 

条 被 用 以 显示 当前 应 用 程序 的 运行 状况 、 功 能 完成 多 少 等 情况 。Android SDK 提供 两 种 样式 的 进度 
条 ， 一 种 是 圆 形 的 进度 条 ， 另 一 种 是 水 平 进度 条 。 其 中 圆 形 进度 条 分 大 、 中 、 小 三 种 。 

进度 条 本 质 上 是 一 个 整数 ， 显 示 当 前 的 整数 值 在 特定 范围 内 的 比重 。 下 面 用 一 个 简单 的 实例 
讲解 ProgressBar 组 件 的 使 用 方法 。 

在 工程 WidgetDemo 的 布局 文件 main.xml 中 添加 一 个 名 为 ProgressBarDemo 的 Button, HH LA 
启动 ProcessBarActivity。 

在 main.xml 中 添加 代码 如 下 : 
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«Button 
android: id="@+id/button7" 
android: layout_width="wrap content" 
android:layout_height="wrap content" 
android: text="ProgressBarDemo" /> 











单 击 Button 并 启动 ProcessBarActivity 的 代码 如 下 : 


Button processbtn- (Button) this.findViewById (R.id.button7) ; 
processbtn.setOnClickListener (new OnClickListener()( 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
Intent intent=new Intent 


(WidgetDemoActivity.this, ProcessBarActivity.class) ; 


startActivity (intent) ; 
2977 
同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 
<activity android:name="ProcessBarActivity"></activity> 


ProcessBarActivity 的 运行 效果 如 图 4.25 所 示 。 


BB widgetdemo 





图 4.25 ProcessBarActivity 的 运行 效果 


ProcessBarActivity 使 用 的 布局 文件 为 processbar.xml， 其 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: layout_width="match parent" 
android: layout_height="match parent" 
android:orientation="vertical"> 
<ProgressBar 
android: id="@+id/progressBarl" 
style-"?android:attr/progressBarStyleSmall" 
android:layout width-"wrap content" 
android:layout height-"wrap content" /» 
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<ProgressBar 
android: id="@+id/progressBar2" 
android: layout_width="wrap content" 
android: layout_height="wrap content" /> 


<ProgressBar 
android: id="@tid/progressBar3" 
style-"?android:attr/progressBarStyleLarge" 
android:layout width-"wrap content" 
android:layout height-"wrap content" /» 


<ProgressBar 
android: id="@tid/progressBar4" 
style="?android:attr/progressBarStyleHorizontal" 
android: layout_width="209dp" 
android: layout_height="30dp" 
android:max="100"/> 


</LinearLayout> 


该 布局 中 放置 了 小 、 中 、 大 三 种 类 型 的 圆 形 进度 条 各 一 个 ， 以 及 一 个 水 平 放置 的 条 形 进 度 条 。 
一 般 情况 下 ,开发 人 员 不 会 为 圆 形 进度 条 指定 进度 ， 圆 形 进度 条 只 是 展示 运行 效果 ， 而 不 反映 实际 
的 进度 。 条 形 进度 条 则 不 同 , 开发 人 员 会 为 条 形 进 度 条 指定 最 大 值 , 以 及 进度 条 当前 值 的 获取 方法 。 
在 本 实例 中 ， 条 形 进度 条 的 最 大 值 为 100。 

ProcessBarActivity.java 的 代码 如 下 : 


package introduction.android.widgetDemo; 


import android.app.Activity; 
import android.os.Bundle; 

import android.os.Handler; 

import android.widget .ProgressBar; 


public class ProcessBarActivity extends Activity { 
ProgressBar progressBar; 
int i=0; 
int progressBarMax=0; 
/* 创建 Handler 对 象 */ 
Handler handler=new Handler(); 


@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.processbar) ; 
progressBar= (ProgressBar) findViewById (R.id.progressBar4) ; 
/* 获取 最 大 值 */ 
progressBarMax-progressBar.getMax(); 
/* 匿名 内 部 类 启动 实现 效果 的 线程 */ 
new Thread (new Runnable (){ 
@Override 
public void run() { 
while (i++<progressBarMax) { 
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// 设置 滚动 条 当前 状态 值 


progressBar.setProgress (i) ; 
try { 
Thread. sleep (15) ; 


} catch (Exception e) { 
e.printStackTrace(); 
} 
} 
} 
}) .start(); 


} 


ProcessBarActivity 对 水 平 进度 条 进行 了 处 理 。 先 获取 了 水 平 进度 条 的 最 大 值 ， 然 后 启动 了 一 
个 线程 ， 由 该 线程 来 控制 进度 条 的 值 ， 从 0 开始 ， 每 隔 15 毫秒 增加 1。 


44.11 滚动 视图 


当 Activity 提供 的 用 户 界 面 上 有 很 多 内 容 ， 以 至 于 当前 手机 屏幕 不 能 完全 显示 全 部 内 容 时 ， 就 
需要 滚动 视图 来 帮助 浏览 全 部 的 内 容 。 

以 工程 WidgetDemo 为 例 , 由 于 在 讲述 过 程 中 不 断 地 在 main.xml 文件 中 添加 按钮 和 其 他 组 件 ， 
目前 已 经 不 能 显示 全 部 内 容 ， 效 果 如 图 4.26 所 示 。 


| WidgetDemo 
Hello World, WidgetDemoActivity! 


Button 


CheckBoxDemo 


RadioGroupDemo 


SpinnerDemo 
AutoCompleteTextViewDemo 


Date/Time 


PronreecRarniema 








图 4.26 添加 大 量 组 件 后 的 效果 


这 时 候 就 需要 使 用 ScrollView， 即 将 当前 的 Activity 的 视图 转化 为 滚动 视图 ， 以 便于 浏览 。 
ScrollView 的 使 用 非常 方便 ,只 需 在 main.xml 的 <LinearLayout> 标 签 外 面 加 上 ScrollView 组 件 的 声 
明 即 可 。 布 局 文件 main.xml 的 内 容 如 下 : 


<ScrollView 





xmlns:android-"http://schemas.android.com/apk/res/android" 
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android: layout_width="fill parent" 


android: layout_height="fill parent"> 


<LinearLayout>... 


</ScrollView> 


.</LinearLayout> 


添加 ScrollView Ja, main.xml 布局 的 运行 效果 如 图 4.27 所 示 。 


44.12. deu 





[a WidgetDemo 


Button 


CheckBoxDemo 
RadioGroupDemo 
SpinnerDemo 
AutoCompleteTextViewDemo 
Date/Time 


ProgressBarDemo 


图 4.27 ScrollView 的 运行 效果 


SeekBar 是 水 平 进度 条 ProgressBar 的 间接 子 类 ， 相 当 于 一 个 可 以 拖 动 的 水 平 进度 条 。 下 面 仍 
以 一 个 简单 的 实例 讲解 SeekBar 组 件 的 使 用 方法 。 
在 工程 WidgetDemo 的 布局 文件 main.xml 中 添加 一 个 名 为 “SeekBarDemo” 的 Button， 用 以 


启动 SeekBarActivity。 


在 main.xml 中 添加 代码 如 下 : 


<Button 


android:id="@+id/button8" 


android:layout_width="wrap content" 
android:layout_height="wrap content" 
android:text="SeekBarDemo" /> 


单 击 Button 并 启动 SeekBarActivity 的 代码 如 下 : 


Button processbtn- (Button) this.findViewById (R.id.button8) ; 
processbtn.setOnClickListener (new OnClickListener () { 





@Override 


public void onClick (View v) { 
// TODO Auto-generated method stub 
Intent intent=new Intent (WidgetDemoActivity.this, SeekBarActivity.class) ; 
startActivity (intent) ; 


De 
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同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 
«activity android:name="SeekBarActivity"></activity> 


SeekBarActivity 的 运行 效果 如 图 4.28 所 示 。 


| | WidgetDemo 
当前 进度 为 : 41% 





图 4.28 SeekBarActivity 的 运行 效果 


SeekBarActivity 使 用 的 布局 文件 为 seekbar.xml， 其 内 容 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 

<LinearLayout xmlns:android="http://schemas. android. com/apk/res/android" 
android: layout_width="match parent" 
android:layout height-"match parent" 
android:orientation-"vertical"» 


<TextView 
android: id="@tid/textViewl” 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android:text-"TextView" /> 


<SeekBar 
android: id="@+id/seekBarl" 
android: layout_width="match parent" 
android: layout_height="wrap content" 
android:max="100"/> 


</LinearLayout> 


该 文件 确定 SeekBar 对 象 的 最 大 值 为 100， 宽 度 为 手机 屏幕 的 宽度 。 
SeekBarActivity java 的 代码 如 下 : 


package introduction.android.widgetDemo; 


import android.app.Activity; 
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BA 


4.4.13 


import android.os.Bundle; 


import android.util.Log; 


import android.widget.SeekBar; 


import android.widget.TextView; 


public class SeekBarActivity extends Activity { 
private TextView textView; 


private SeekBar seekBar; 
@Override 


public 


void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState) ; 
setContentView (R.layout.seekbar) ; 

textView- (TextView) findViewById (R.id.textViewl) ; 
seekBar- (SeekBar) findViewById (R.id.seekBarl) ; 


/* 


设置 SeekBar 监听 setOnSeekBarChangeListener */ 


seekBar.setOnSeekBarChangeListener (new SeekBar.OnSeekBarChangeListener () { 


p 


/* 拖 动 条 停止 拖 动 时 调用 */ 

@Override 

public void onStopTrackingTouch (SeekBar seekBar) { 
Log.i ("SeekBarActivity", "j&zhfEib") ; 

} 

/* 拖 动 条 开始 拖 动 时 调用 */ 

@Override 

public void onStartTrackingTouch (SeekBar seekBar) { 
Log.i ("SeekBarActivity"，" 开 始 拖 动 ") ; 

} 

/* 拖 动 条 进度 改变 时 调用 */ 

@Override 

public void onProgressChanged (SeekBar seekBar, int progress, 
boolean fromUser) { 
textView.setText (" 当 前 进度 为 : "+progress+"%") ; 





SeekBar 的 寻 





在 网 上 购物 


有 件 处 理 接口 为 OnSeekBarChangeListener， 该 监听 器 提供 对 三 种 事件 的 监听 , 分别 
为 当 SeekBar 的 拖 动 条 开始 被 拖 动 时 、 拖 动 条 拖 动 停止 时 和 拖 动 条 的 位 置 发 生 改变 时 。 

SeekBarActivity 在 拖 动 条 开始 被 拖 动 和 拖 动 停止 时 ， 会 通过 Logcat 打印 相关 信息 。 当 拖 动 条 位 置 
E 改 变 时 ， 将 当前 的 数值 显示 到 TextView H. 


评价 条 


的 时 候 ， 经 常会 对 所 购买 的 商品 进行 打分 。 一 般 对 商品 的 评价 和 打分 是 以 5 个 星 


星 的 方式 进行 的 。Android SDK 提供 了 RatingBar 组 件 来 实现 该 功能 。 


RatingBar 是 SeekBar 和 ProgressBar 的 扩展 , 是 ProgressBar 的 间接 子 类 , 可 以 使 用 ProgressBar 
相关 的 属性 。 RatingBar 有 三 种 风格 , 分 别 为 默认 风格 (ratingBarStyle)、 小 风格 (ratingBarStyleSmall) 
和 大 风格 (ratingBarStyleIndicator ) 。 其 中 ， 默 认 风 格 的 RatingBar 是 我 们 通常 使 用 的 ， 可 以 进行 


交互 ， 而 其 他 两 种 不 能 进行 交互 。 
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以 一 个 简单 的 实例 讲解 RatingBar 组 件 的 使 用 方法 。 在 工程 WidgetDemo 的 布局 文件 main.xml 


中 添加 一 个 名 为 “RatingBarDemo” 的 Button， 用 以 启动 RatingBarActivity。 


在 main.xml 中 添加 代码 如 下 : 


<Button 
android:id="@+id/button9" 
android:layout_width="wrap content" 
android:layout height-"wrap content" 
android:text-"RatingBarDemo" /> 





单 击 Button 并 启动 RatingBarActivity 的 代码 如 下 : 


Button ratingbarbtn= (Button) this.findViewById (R.id.button9) ; 
ratingbarbtn.setOnClickListener (new OnClickListener() { 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
Intent intent=new Intent (WidgetDemoActivity.this, RatingBarActivity.class) ; 
startActivity (intent) ; 


FOLE 
同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 
<activity android:name="RatingBarActivity"></activity> 


RatingBarActivity 的 运行 效果 如 图 4.29 所 示 。 


| WidgetDemo 
您 选择 了 3.5 个 星星 


kk kkk 





图 4.29 RatingBarActivity 的 运行 效果 
RatingBarActivity 使 用 的 布局 文件 ratingbar.xml 的 内 容 如 下 : 


<?xml version-"1.0" encoding="utf-8"2> 

<LinearLayout xmlns:android="http://schemas. android. com/apk/res/android" 
android: layout_width="match parent" 
android: layout_height="match parent" 
android: orientation="vertical"> 
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<TextView 
android: id="@+tid/textViewl" 
android: layout width-"wrap content" 
android: layout_height="wrap content" 
android: text="TextView" /> 


<RatingBar 
android: id="@+id/ratingBarl” 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android:numStars="5" 
android: stepSize="0.5" 
android: rating="3"/> 


</LinearLayout> 


该 布局 文件 使 用 LinearLayout 布局 ， 其 中 放置 了 一 个 TextView 和 一 个 RatingBar， 并 对 





RatingBar 的 相关 属性 进行 了 设置 。android:numStars 


个 ; android:stepSize="0.5" 用 于 设置 RatingBar 的 最 小 变化 单位 为 半 个 


RatingBar 在 初始 状态 下 被 选中 的 星星 数量 为 3 个 。 
RatingBarActivity java 的 代码 如 下 : 


package introduction.android.widgetDemo; 


import android.app.Activity; 

import android.os.Bundle; 

import android.util.Log; 

import android.view.MotionEvent; 

import android.view.View; 

import android.view.View.OnTouchListener; 
import android.widget.RatingBar; 


"用 于 设置 RatingBar 显示 的 星星 数量 为 5 
星 ; android:rating ="3" 表 示 





import android.widget.RatingBar.OnRatingBarChangeListener; 


import android.widget.TextView; 
import android.widget.Toast; 


public class RatingBarActivity extends Activity { 
private RatingBar chooseRatingBar; 
private TextView textView; 
@Override 


public void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState) ; 
setContentView (R.layout.ratingbar) ; 


textView- (TextView) findViewById (R.id.textViewl) ; 
chooseRatingBar= (RatingBar) findViewById (R.id.ratingBarl) ; 


/* 创 建 RatingBar 监听 器 */ 


chooseRatingBar.setOnRatingBarChangeListener (new 


OnRatingBarChangeListener () { 


@Override 


public void onRatingChanged (RatingBar ratingBar, float rating, boolean fromUser) 


chooseRatingBar- (RatingBar) findViewById (R.id.ratingBarl) ; 
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RatingBarActivity 为 RatingBar 对 象 设 置 了 OnRatingBarChangeListener 监听 器 ， 当 用 户 单 击 


chooseRatingBar.setRating (rating) ; 
textView.setText ("您 选择 了 "+rating+" 个 星星 ") ; 





RatingBar 引起 被 选中 星星 数量 的 变化 时 ， 该 接口 会 监测 到 该 事件 ， 并 且 调 用 onRatingChanged0 方 
法 ， 更 新 TextView 显示 的 内 容 。 
onRatingChanged0 的 三 个 参数 所 对 应 的 含义 如 下 。 


ratingBar: 多 个 RatingBar 可 以 同时 指定 同一 个 RatingBar 监听 器 。 该 参数 就 是 当前 触发 
RatingBar 监听 器 的 那个 RatingBar 对 象 。 

rating: 当前 评级 分 数 。 取 值 范围 从 0 到 RatingBar 的 总 星星 数 。 

fromUser: 如 果 触 发 监听 器 的 是 用 户 触 屏 单 击 或 轨迹 球 左右 移动 ， 则 为 true, 


44.14 ”图 片 视图 和 图 片 按钮 


ImageView 是 用 于 显示 图 片 的 组 件 , 在 很 多 场合 都 有 比较 普遍 的 使 用 。 ImageView 可 以 显示 任 
意图 像 ， 加 载 各 种 来 源 的 图 片 〈 如 资源 或 图 片 库 ) 。ImageView 可 以 负责 计算 图 片 的 尺寸 ， 以 便 在 
任意 的 布局 中 使 用 ， 并 且 可 以 提供 缩放 或 者 着 色 等 选项 供 开 发 者 使 用 。 

ImageButton 是 ImageView 的 子 类 ， 相 当 于 一 个 表明 是 图 片 而 不 是 文字 的 Button。 其 使 用 方法 
和 Button 完全 相同 。 

下 面 通过 一 个 实例 来 了 解 一 下 这 两 个 组 件 的 使 用 方法 。 在 工程 WidgetDemo 的 布局 文件 
main.xml 中 添加 一 个 名 为 ImageButtonDemo 的 Button， 用 以 启动 ImageButtonActivity. 

在 main.xml 中 添加 代码 如 下 : 


<Button 


android: id="@+id/button10" 

android: layout_width="wrap content" 
android: layout_height="wrap content" 
android: text="ImageButtonDemo" /> 


单 击 Button 并 启动 RatingBarActivity 的 代码 如 下 : 


Button imgbtn- (Button) this.findViewById (R.id.button10) ; 
imgbtn.setOnClickListener (new OnClickListener () { 


Ds 


@Override 

public void onClick (View v) { 
// TODO Auto-generated method stub 
Intent intent=new Intent (WidgetDemoActivity.this, ImageButtonActivity.class) ; 
startActivity (intent) ; 


同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 


<activity android:name="ImageButtonActivity"></activity> 
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ImageButtonActivity 的 运行 效果 如 图 4.30 所 示 。 





a WidgetDemo 





图 4.30  ImageButtonActivity 的 运行 效果 


ImageButtonActivity 的 布局 文件 imgbtn.xml 内 容 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 

<LinearLayout xmlns:android="http://schemas. android. com/apk/res/android" 
android: layout_width="match parent" 
android: layout_height="match parent" 
android:orientation="vertical"> 


<ImageView 
android: id="@tid/imageViewl" 
android: layout_width="250dp" 
android: layout_height="250dp" 
android: src="@drawable/girl" /> 


<ImageButton 
android: id="@+id/imageButton1" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android:sre="@drawable/ic launcher" /> 


</LinearLayout> 


该 文件 使 用 LinearLayout 布局 , 其 中 放 入 了 一 个 ImageView 组 件 和 一 个 ImageButton 组 件 。 两 
个 组 件 都 通过 android:sre 属性 指定 了 显示 的 图 片 。 该 实例 用 到 了 两 个 图 片 资源 ， 一 个 为 girl， 另 一 


个 为 ic launcher, 如 图 4.31 所 示 。 由 于 Android 会 根据 手机 设备 的 配置 高 低 选择 不 同 的 资源 ， 





因此 





为 了 应 用 程序 的 通用 性 ， 在 三 个 drawable 文件 夹 下 都 放置 了 girl. gif 图 像 。ic_launcherpng 是 系统 


自 带 的 资源 文件 。 
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图 4.31 工程 中 的 图 片 资源 


ImageButtonActivity.java 的 代码 如 下 : 


package introduction.android.widgetDemo; 
import android.app.Activity; 
import android.os.Bundle; 
import android.view.View; 
import android.view.ViewGroup.LayoutParams; 
import android.widget .ImageButton; 
import android.widget.ImageView; 
public class ImageButtonActivity extends Activity { 
private ImageButton imgbtn; 
private ImageView imgview; 
@Override 
protected void onCreate (Bundle savedInstanceState) { 
// TODO Auto-generated method stub 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.imgbtn) ; 
imgbtn- (ImageButton) this.findViewById (R.id.imageButtonl) ; 
imgview- (ImageView) this.findViewById (R.id.imageViewl) ; 
imgbtn.setOnClickListener (new View.OnClickListener () { 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
LayoutParams params=imgview.getLayoutParams () ; 
params .height+=3; 
params .width+=37 
imgview.setLayoutParams (params) ; 


Ds 








ImageButtonActivity 7j ImageButton 添加 了 单 击 监听 器 ,对 用 户 单 击 imgbtn 的 事件 进行 了 处 理 。 
用 户 每 次 单 击 图 片 按钮 ， 都 把 ImageView 组 件 的 宽 和 高 增 大 3。 随 着 用 户 的 不 断 单 击 ，ImageView 
中 显示 的 图 片 越 来 越 大 ， 显 示 了 ImageView 组 件 对 图 片 的 缩放 功能 。 
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4415 图片 切 换 器 和 图 库 


在 使 用 Android 手机 设置 壁纸 的 时 候 , 会 看 到 屏幕 底部 有 很 多 可 以 滚动 的 图 片 ， 当 单 击 某 一 图 








片 时 ,在 其 上 面 的 空间 会 显示 当前 选中 的 图 片 , 此 时 我 们 用 到 的 就 是 Gallery 图 库 ) 和 ImageSwitcher 


(图 片 切 换 器 )。 


Gallery 组 件 用 于 横向 显示 图 像 列表 ， 并 且 自 动 将 当前 图 像 放置 到 中 间 位 置 。ImageSwitcher 则 


像 是 图 片 浏览 器 ,可 以 切换 图 片 , 通过 它 可 以 制作 简单 的 幻灯 片 等 。 通常 将 这 两 个 类 





用 ， 可 以 制作 有 一 定 效果 的 相册 。 


下 面 通过 一 个 实例 来 了 解 一 下 这 两 个 组 件 的 使 用 方法 。 


结合 在 一 起 使 


在 工程 WidgetDemo 的 布局 文件 main.xml 中 添加 一 个 名 为 GalleryDemo 的 Button， 用 以 启动 


GalleryActivity。 在 main.xml 中 添加 代码 如 下 : 


<Button 
android: id="@+tid/buttonl1" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android:text="GalleryDemo" /> 


单 击 Button 并 启动 GalleryActivity 的 代码 如 下 : 


Button gallerybtn= (Button) this.findViewById 
(R.id.buttonll) ; 
gallerybtn.setOnClickListener (new 
OnClickListener () { 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
Intent intent=new Intent 
(WidgetDemoActivity.this, GalleryActivity.class) ; 
startActivity (intent) ; 
) 
Ds 


同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 


<activity 
android:name="GalleryActivity"></activity> 


GalleryActivity 的 运行 效果 如 图 4.32 所 示 。 


GalleryActivity 使 用 的 布局 文件 为 gallery.xml, 3€ 


如 下 : 


<?xml version="1.0" encoding="utf-8"?> 


<RelativeLayout xmlns:android="http: //schemas.android.com/apk/res/android" 


android: layout_width="fill_ parent" 
android: layout_height="fill_ parent" 
android: orientation="vertical"> 
<ImageSwitcher 
android: id="@+id/switcher" 
androi 





:layout width-"match parent" 
android:layout height-"match parent" 


F WidgetDemo 





图 4.32 GalleryActivity 的 运行 效果 
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android: layout_alignParentTop="true" 
android: layout_alignParentLeft="true"> 
</ImageSwitcher> 
<Gallery 
android: id="@+id/gallery” 
android: background="#333333" 
android: layout_width="fill parent" 
android: layout_height="60dp" 
android: layout_alignParentBottom="true” 
android: layout_alignParentLeft="true” 
android:gravity-"center vertical" 
android:spacing-"16dp" /> 
</RelativeLayout> 


该 布局 文件 使 用 的 是 相对 布局 ,通过 android:layout_alignParentTop="true" 属 性 将 ImageSwitcher 
放置 于 视图 的 顶端 , 其 顶部 与 其 父 组 件 的 顶部 对 齐 , 同时 使 用 android: layout_alignParentLeft="true" 
属性 使 ImageSwitcher 的 左边 缘 与 其 父 组 件 的 左边 缘 对 齐 。 在 设置 Gallery 组 件 时 ， 将 其 与 屏幕 的 
左下 角 对 其 ，android:layout_alignParentBottom="true" 是 将 该 组 件 的 底部 与 其 父 组 件 的 底部 对 齐 ， 并 
且 使 用 android:spacing="16dp" 属 性 设置 图 片 之 间 的 间距 。 

GalleryActivity.java 的 代码 如 下 : 


package introduction.android.widgetDemo; 














import android.app.Activity; 

import android.content.Context; 

import android.os.Bundle; 

import android.view.View; 

import android.view.ViewGroup; 

import android.view.ViewGroup.LayoutParams; 
import android.view.animation.AnimationUtils; 
import android.widget.AdapterView; 

import android.widget .AdapterView.OnItemSelectedListener; 
import android.widget.BaseAdapter; 

import android.widget.Gallery; 

import android.widget.ImageSwitcher; 

import android.widget.ImageView; 

import android.widget.ViewSwitcher.ViewFactory; 


public class GalleryActivity extends Activity { 
private Gallery gallery; 
private ImageSwitcher imageSwitcher; 
private int[] resids-new int[] { 

R.drawable.sample 0, R.drawable.sample 1, 
R.drawable.sample 2, R.drawable.sample 3, 
R.drawable.sample 4, R.drawable.sample 5, 
R.drawable.sample 6, R.drawable.sample 7); 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.gallery) ; 
/* WME Gallery 和 ImageSwitcher */ 
gallery- (Gallery) findViewById (R.id.gallery) ; 
imageSwitcher- (ImageSwitcher) findViewById (R.id.switcher) ; 
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/* 创建 用 于 描述 图 像 数据 的 Imageadapter WR */ 

ImageAdapter imageAdapter=new ImageAdapter (this) ; 

/* WS Gallery Ath Adapter WR */ 

gallery.setAdapter (imageAdapter) ; 

/* 添加 Gallery 监听 器 */ 

gallery.setOnItemSelectedListener (new OnItemSelectedListener () { 


@Override 
public void onItemSelected (AdapterView<?>parent, View view, 
int position, long id) { 
// TODO Auto-generated method stub 
// 当选 取 Grallery 上 的 图 片 时 ， 在 ImageSwitcher 组 件 中 显示 该 图 像 


imageSwitcher.setImageResource (resids[position]) ; 


GOverride 
public void onNothingSelected (AdapterView«?»arg0) { 
// TODO Auto-generated method stub 


PLE 
/* WH ImageSwitcher 组件 的 工厂 对 象 */ 
imageSwitcher.setFactory (new ViewFactory () { 
/* ImageSwitcher 用 这 个 方法 来 创建 一 个 View 对 象 去 显示 图 片 */ 
@Override 
public View makeView() { 
// TODO Auto-generated method stub 
ImageView imageView-new ImageView (GalleryActivity.this) ; 
/* setScaleType 可 以 设置 当 图 片 大 小 和 容器 大 小 不 匹配 时 的 剪辑 模式 */ 
imageView.setScaleType (ImageView.ScaleType.FIT CENTER) ; 
imageView.setLayoutParams (new ImageSwitcher.LayoutParams ( 
LayoutParams.FILL PARENT, LayoutParams.FILL PARENT)) ; 


return imageView; 


Du 

/* WH ImageSwitcher 组 件 显示 图 像 的 动画 效果 */ 

imageSwitcher.setInAnimation (AnimationUtils.loadAnimation (this, 
android.R.anim.fade in) ; 

imageSwitcher.setOutAnimation (AnimationUtils.loadAnimation (this, 
android.R.anim.fade out)) ; 


public class ImageAdapter extends BaseAdapter { 
/* ÆX Context */ 
private Context mContext; 


/* 声明 ImageAdapter */ 
public ImageAdapter (Context context) { 


mContext-context; 


@Override 
/* 获取 图 片 的 个 数 */ 
public int getCount() { 
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// TODO Auto-generated method stub 
return resids.length; 
} 


/* 获取 图 片 在 库 中 的 位 置 */ 

@Override 

public Object getItem (int position) { 
// TODO Auto-generated method stub 
return position; 

} 


/* 获取 图 片 ID */ 

@Override 

public long getItemId (int position) { 
// TODO Auto-generated method stub 
return position; 

» 


/* 返回 具体 位 置 的 ImageView HR */ 
@Override 
public View getView (int position, View convertView, ViewGroup parent) { 
ImageView imageview=new ImageView (mContext) ; 
/* 给 InageView 设置 资源 */ 
imageview.setImageResource (resids[position]) ; 
/* 设置 图 片 布局 大 小 为 100*100 */ 
imageview.setLayoutParams (new Gallery.LayoutParams (100, 100)) ; 
/* 设置 显示 比例 类 型 */ 
imageview.setScaleType (ImageView.ScaleType.FIT XY) ; 
return imageview; 


} 


Gallery 要 显示 的 图 片 来 自 资 源 文 件 。 把 需要 显示 的 图 片 放 在 /res/drawable 目录 下 后 , 将 这 些 图 
片 的 ID 保存 在 一 个 int 数组 中 以 备 使 用 。 相 关 代 码 如 下 


Private int[] resids=new int[] { 
R.drawable.sample 0, R.drawable.sample 1, 
R.drawable.sample 2, R.drawable.sample 3, 
R.drawable.sample 4, R.drawable.sample 5, 
R.drawable.sample 6, R.drawable.sample 7}; 

Gallery 通过 setAdapter CimageAdapter) 方法 将 组 件 和 要 显示 的 图 片 关联 起 来 。 本 实例 中 为 
Gallery 设 定 的 适配器 为 ImageAdapter， 主 要 用 于 描述 图 像 信息 ， 其 为 android.widget.BaseAdapter 
的 子 类 。 

在 ImageAdapter 类 中 有 两 个 方法 值得 我 们 注意 , 其 中 一 个 是 getCount0 方 法 , 它 用 于 返回 图 片 
的 总 数 , 通常 使 用 获取 存放 图 片 数 组 长 度 的 方法 获取 图 片 总 数 ， 也 可 以 规定 具体 的 返回 数 , 但 不 能 
超过 实际 图 片 数量 ，getView0 方 法 是 当 Gallery 中 需要 显示 某 一 个 图 像 时 ， 将 当前 图 片 的 索引 ， 也 
就 是 position 的 值 传 入 ， 从 resids 数组 中 获得 相应 的 图 片 的 IDo 

GalleryActivity 为 添加 Gallery 监听 器 ， 处 理 了 用 户 单 击 Gallery 中 图 片 的 事件 ， 并 设置 了 
ImageSwitcher 相关 属性 。 其 代码 如 下 : 








a 
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imageSwitcher.setInAnimation (AnimationUtils.loadAnimation (this, 


android.R.anim.fade in)) ; 


imageSwitcher.setOutAnimation (AnimationUtils.loadAnimation (this, 
android.R.anim.fade out)) ; 


设置 了 ImageSwitcher 组 件 图 片 切换 时 的 渐 入 和 渐 出 效果 。 


4416 网 格 视图 


GridView 提供 了 一 个 二 维 的 可 滚动 的 网 格 ， 按 照 行列 的 方式 来 显示 内 容 ,一 般 适 合 显示 图 标 、 
图 片 等 ， 适 合 浏览 。 

下 面 通过 一 个 实例 来 了 解 一 下 GridView 组 件 的 使 用 方法 。 在 工程 WidgetDemo 的 布局 文件 
main.xml 中 添加 一 个 名 为 GridViewDemo 的 Button， 用 以 启动 GridViewActivity. 

在 main.xml 中 添加 代码 如 下 : 


<Button 
android: id="@+id/button12" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android:text-"GridViewDemo" /> 


单 击 Button 并 启动 GridViewActivity 的 代码 如 下 : 


Button gridviewbtn= (Button) this.findViewById 
(R.id.buttonl2) ; 
gridviewbtn.setOnClickListener (new 
OnClickListener()( 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
Intent intent=new Intent 
(WidgetDemoActivity.this, GridViewActivity.class) ; 
startActivity (intent) ; 
} 
D: 


同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 


<activity android:name-"GridViewActivity"» 
</activity> 





GridViewActivity 的 运行 效果 如 图 4.33 所 示 。 
GridViewActivity 使 用 的 布局 文件 为 gridview.xml, 图 4.33 GridViewActivity 的 运行 效果 
其 内 容 如 下 : 
<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas. android. com/apk/res/android” 
android:layout width-"match parent" 


android:layout height-"match parent" 
android:orientation-"vertical"» 


<GridView 
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android: id="@+id/gridViewl" 
android: layout_width="match parent" 
android: layout height-"wrap content" 


android:numColumns="3"> 


</GridView> 


</LinearLayout> 





ME 











采用 LinearLayout 的 布局 方式 ， 其 中 放置 了 一 个 GridView 组 件 ， 该 组 件 由 三 列 组 成 。 
GridViewActivity java 的 代码 如 下 : 


package introduction.android.widgetDemo; 


public 


android.app.Activity; 
android.content.Context; 
android.os.Bundle; 
android.util.Log; 
android.view.View; 
android.view.ViewGroup; 
android.widget.AdapterView; 
android.widget.AdapterView.OnItemClickListener; 
android.widget.BaseAdapter; 
android.widget.GridView; 
android.widget.ImageView; 


class GridViewActivity extends Activity { 


public void onCreate (Bundle savedInstanceState) ( 


super.onCreate (savedInstanceState) ; 
setContentView (R.layout.gridview) ; 


GridView gridview- (GridView) findViewById (R.id.gridViewl) ; 
gridview.setAdapter (new ImageAdapter (this)) ; 


gridview.setOnItemClickListener (new OnItemClickListener() { 
public void onItemClick (AdapterView<?>parent, View v, 
int position, long id) { 
Log.i ("gridview"，" 这 是 第 "+position+" 幅 图 像 。") ; 


p: 


public class ImageAdapter extends BaseAdapter { 


private Context mContext; 


public ImageAdapter (Context c) ( 
mContext-c; 


/* 获取 当前 图 片 数 量 */ 

&Override 

public int getCount()| 
return mThumbIds.length; 


/* 根据 需要 position 获得 在 GridView PHMR */ 
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&Override 
public Object getItem (int position) { 
return position; 


) 


/* 获得 在 GridView 中 对 象 的 ID */ 
@override 
public long getItemId (int id) { 

return id; 


@Override 
public View getView (int position, View convertView, ViewGroup parent) { 


ImageView imageView; 


if (convertView==null) { 
/* 实例 化 ImageView MR */ 


imageView=new ImageView (mContext) ; 


} 


} 


/* WH ImageView 对 象 布局 ， 设 置 View 的 height 和 width */ 


imageView.setLayoutParams (new GridView.LayoutParams (85, 85)) ; 


/* 设置 边界 对 齐 */ 


imageView.setAdjustViewBounds (false) ; 
/* 按 比 例 统一 缩放 图 片 〈 保 持 图 片 的 尺寸 比例 ) */ 


imageView.setScaleType (ImageView.ScaleType.CENTER CROP) ; 


/* 设置 间距 */ 


imageView.setPadding (8, 8, 8, 8); 


else { 


imageView- (ImageView) convertView; 


imageView.setImageResource (mThumbIds [position]) ; 
return imageView; 


// references to our images 
private Integer[] mThumbIds={ 


R 
R 
R 
R 
R 
R 
R 


) 


.drawable.sample 4, 
.drawable.sample 7, 
-drawable.sample 2, 
.drawable.sample 5, 
.drawable.sample 0, 
.drawable.sample 3, 
-drawable.sample 6, 


R.drawable.sample 2, 


R.drawable 


R.drawable. 


R.drawable 
R.drawable 


-sample 6, 
-sample 1, 
R.drawable. 
R.drawable. 


R.drawable.sample 3, 
-sample 5, R.drawable.sample 6, 
R.drawable. 


sample 0, R.drawable.sample 1, 
sample 3, R.drawable.sample 4, 


R 
R 


.drawable.sample 7, 
.drawable.sample 2, 


sample 4, R.drawable.sample 5, 


sample 7 }; 


在 主 程序 GridViewActivity 中 , 为 GridView 设置 了 一 个 数据 适配器 , 并 处 理 了 GridView 的 单 


slat 





击 事件 。 适 配器 继承 自 BaseAdapter 2$, 5 4.4.15 节 中 用 到 的 适配器 高 度 相 似 ， 在 此 不 再 


4417 标签 














复 。 


在 有 限 的 手机 屏幕 空间 内 ， 当 要 浏览 的 内 容 较 多 ， 无 法 在 一 个 屏幕 空间 内 全 部 显示 时 ， 可 以 
使 用 滚动 视图 来 延长 屏幕 的 空间 。 当 浏览 的 内 容 具 有 很 强 的 类 别 性 质 时 ,更 合适 的 方法 是 将 不 同类 
别 的 内 容 集中 到 各 自 的 面板 中 ， 这 时 就 需要 使 用 面板 标签 Tab) 组 件 了 。 
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Tab 组 件 利用 面板 标签 把 不 同 的 面板 内 容 切换 到 屏幕 上 ， 以 显示 不 同类 别 的 内 容 。 

下 面 通过 一 个 实例 来 了 解 一 下 Tab 组 件 的 使 用 方法 。 在 工程 WidgetDemo 的 布局 文件 main.xml 
中 添加 一 个 名 为 TabDemo 的 Button， 用 以 启动 TabActivity。 

在 main.xml 中 添加 代码 如 下 : 


<Button 
android: id="@tid/button13" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android: text="TabDemo" /> 


单 击 Button 并 启动 GridViewActivity 的 代码 如 下 : 


Button tabbtn- (Button) this.findViewById (R.id.button13) ; 
tabbtn.setOnClickListener (new OnClickListener() { 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
Intent intent=new Intent (WidgetDemoActivity.this, TabActivity.class) ; 
startActivity (intent) ; 
) 
Polen 


同时 在 AndroidManifest.xml 文件 中 声明 该 Activity: 
<activity android:name="TabActivity"></activity> 


TabActivity 的 运行 效果 如 图 4.34 所 示 。 


| WidgetDemo 


Tab3 页 面 





图 434 TabActivity 的 运行 效果 











要 使 用 Tab 必然 涉及 它 的 容器 TabHost, TabHost 包括 TabWigget 和 FrameLayout 两 部 分 。 
TabWidget 就 是 每 个 Tab 的 标签 ，FrameLayout 是 Tab 的 内 容 。 

TabActivity 使 用 的 布局 文件 是 tab.xml。 在 tab.xml 中 定义 了 每 个 Tab 中 要 显示 的 内 容 ， 代 码 
如 下 : 








112 | Android 7 应 用 程序 开发 教程 





<?xml version-"1.0" encoding-"utf-8"?» 
<TabHost xmlns:android-"http://schemas.android.com/apk/res/android" 
android: id="@+id/tabhost” 
android: layout_width="fill parent" 
android: layout_height="fill_parent"> 
<LinearLayout 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
android: orientation="vertical"> 
<TabWidget 
android: id="@android:id/tabs” 
android: layout_width="fill parent" 
android: layout_height="wrap content" /> 
<FrameLayout 
android: id="@android:id/tabcontent” 
android: layout_width="fill parent" 
android: layout_height="fill parent"» 
<TextView 
android: 
android: 
android: 
android: 
android: 
<TextView 


id="@+id/tab1” 

layout width-"wrap content" 
layout height-"wrap content" 
textSize-"40dp" 

text-"Tabl Wifi" /> 

android: id="@+id/tab2" 


android:layout width-"wrap content" 


android: 
android: 
android: 
<TextView 
android: 
android: 
android: 
android: 
android: 
</FrameLayout> 
</LinearLayout> 
</TabHost> 


layout height-"wrap content" 
textSize-"40dp" 
text-"Tab2 Wifi” /> 


id="@+id/tab3”" 

layout width-"wrap content" 
layout height-"wrap content" 
textSize-"40dp" 

text-"Tab3 Wifi" /> 


在 FrameLayout 中 我 们 放置 了 三 个 TextView 组 件 ， 分 别 对 应 三 个 Tab 所 显示 的 内 容 ， 当 切换 
不 同 的 Tab 时 会 自动 显示 不 同 的 TextView 内 容 。 

在 主 程序 TabActivity 的 OnCreate0 方 法 中 ， 首 先 获得 TabHost 的 对 象 ， 并 调用 setup() 方 法 进 
行 初始 化 ， 然 后 通过 TabHost.TabSpec 增加 Tab 页 ， 通 过 setContent0 增 加 当前 Tab 页 显示 的 内 容 ， 
通过 setIndicator 增加 页 的 标签 ， 最 后 设 定 要 显示 的 Tab 页 。 

TabActivity 的 代码 如 下 : 


package introduction.android.widgetDemo; 


ML an 


Sa 


import android.app.Activity; 
import android.os.Bundle; 
import android.widget.TabHost; 


public class TabsActivity extends Activity 
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public void onCreate (Bundle savedInstanceState) { 


增加 页 的 标签 


} 


super.onCreate (savedInstanceState) ; 

setContentView (R.layout.tab) ; 

// 步骤 1: 获得 TabHost 的 对 象 ， 并 进行 初始 化 setup () 

TabHost tabs= (TabHost) findViewById (R.id.tabhost) ; 

tabs.setup(); 

// 步骤 2: Wit TabHost.TabSpec 增加 tab 的 一 页 , 通过 setContent () 增加 内 容 , 通过 setIndicator 


/* 增加 第 1 个 Tab */ 

TabHost.TabSpec spec=tabs.newTabSpec ("Tagl") ; 
// 单 击 Tab 要 显示 的 内 容 

spec.setContent (R.id.tabl) ; 

/* 显示 Tabl AX */ 

spec.setIndicator ("Tabl") ; 

tabs.addTab (spec) ; 

/* 增加 第 2 个 Tab */ 

spec-tabs.newTabSpec ("Tag2") ; 

spec.setContent (R.id.tab2) ;// Mii Tab 要 显示 的 内 容 
/* 显示 Tab2 WH */ 

spec.setIndicator ("Tab2") ; 

tabs.addTab (spec) ; 

/* 增加 第 3 个 Tab */ 

spec-tabs.newTabSpec ("Tag3") ; 

spec.setContent (R.id.tab3) ;// ii Tab 要 显示 的 内 容 
/* 显示 Tab3 内 容 */ 

spec.setIndicator ("Tab3") ; 

tabs.addTab (spec) ; 

/* 步骤 3: 可 通过 setCurrentTab (index) 指定 显示 的 页 ， 从 0 开始 计算 */ 
tabs.setCurrentTab (0) ; 


除了 使 用 上 述 方法 设置 Tab 页 面 的 显示 内 容 外 ， 还 可 以 使 用 setContent (Intent) 方法 启动 某 
个 Activity， 并 将 该 Activity 的 视图 作为 Tab 页 面 的 内 容 。 


例如 : 


Intent intent=new Intent().setClass (this, AlbumsActivity.class) ; 
spec=tabHost.newTabSpec ("albums") .setIndicator ("Albums", 


res.getDrawable (R.drawable.ic_tab_albums)) 
-setContent (intent) ; 


tabHost.addTab (spec) ; 


4.5 Menu fl ActionBar 


菜单 是 人 机 交互 的 重要 接口 ， 在 Android SDK 中 ， 提 供 了 菜单 类 android.view.Menu， 以 完成 
与 菜单 有 关 的 操作 。 


Android SDK 提供 





种 菜单 ， 分 别 如 下 。 


* Options Menu: 选项 菜单 ， 是 Activity 的 主要 菜单 项 的 集合 ， 当 用 户 单 击 Menu 按钮 时 出 现 。 
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在 Android 2.3 以 下 的 版 本 中 ,这 种 菜单 最 多 显示 6 个 带 图 标的 菜单 项 。 当 菜单 中 含有 6 个 以 
上 的 菜单 项 时 ， 弹 出 菜单 将 只 显示 前 5 个 菜单 项 ， 第 6 个 菜单 项 会 变 为 More， 单 击 More X 
单项 后 会 出 现 扩展 菜单 。 扩展 菜单 不 支持 图 标 , 但 支持 单 选 框 和 复 选 框 。 在 Android 3.0 ( API 
Level 11) 及 以 上 版 本 中 ， 默 认 情 况 下 直接 弹出 的 选项 菜单 不 再 显示 图 标 。 

© Context Mem: 上 下 文 菜单 ， 是 一 个 悬浮 的 菜单 项 列表 ， 当 用 户 单 击 注册 了 上 下 文 菜单 的 组 
件 时 出 现 。 上 下 文 菜单 不 支持 菜单 图 标 和 快捷 键 。 

© Submenu: 子 菜单 ， 是 某 个 菜单 项 的 扩展 ， 是 一 个 悬浮 的 菜单 项 列表 。 子 菜单 不 支持 菜单 图 
标 或 者 嵌 套 子 菜单 。 


4.5.1 Options Menu 


要 实现 选项 菜单 的 功能 ， 首 先 需要 重 载 OnCreatOptionsMenu0 方 法 创建 菜单 ， 然 后 通过 
onOptionsItemSelected( 方 法 对 菜单 被 单 击 事件 进行 监听 和 处 理 。 

创建 一 个 名 为 MenusDemo 的 Android Project， 在 该 工程 中 对 菜单 的 相关 知识 进行 学 习 。 

在 工程 的 res 目录 下 创建 一 个 menu 目录 ， 用 于 存放 菜单 相关 的 XML 文件 。 在 该 目录 下 创建 
mymenu.xml， 代 码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<menu xmlns:android="http://schemas.android.com/apk/res/android"> 

<item 

android: id="@+id/item1" 

android:title="@string/menuitem1" 

android: icon="@drawable/icon01"/> 
<item 

android: id="@tid/item2" 

android:title="@string/menuitem2" 

android: icon="@drawable/icon02"/> 
<item 

android: id="@tid/item3" 

android: title="@string/menuitem3" 

android: icon="@drawable/icon03"/> 
<item 

android: id="@tid/item4" 

android:title="@string/menuitem4" 

android: icon="@drawable/icon04"/> 
<item 

android: id="@tid/item5" 

android:title="@string/menuitem5" 

android: icon="@drawable/icon05"/> 
<item 

android: id="@+id/item6" 

android: title="@string/menuitem6" 

android: icon="@drawable/icon06"/> 
<item 

android: id="@tid/item7" 

android:title="@string/menuitem7" 

android: icon="@drawable/icon07"/> 


</menu> 
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mymenu.xml 创建 了 一 个 具有 7 个 菜单 项 的 菜单 ， 并 且 通 过 android:id 属性 为 每 个 菜单 项 指定 
ID, 通过 android:title 属性 为 每 个 菜单 项 指定 显示 的 菜单 项 内 容 , 通过 android:icon 属性 指定 每 个 菜 
单项 的 图 标 。 对 应 的 图 标 文件 放置 到 res/drawable 目录 下 。 

为 工程 MenusDemo 创建 名 为 MenusActivity 的 Activity， 将 mymenu.xml 中 定义 的 菜单 设置 为 
MenusActivity 的 菜单 ， 重 载 OnCreatOptionsMenu() 方 法 。MenusActivity.java 的 代码 如 下 : 





package introduction.android.menusDemo; 


import android.app.ActionBar; 
import android.app.Activity; 
import android.os.Bundle; 

import android.view.Menu; 

import android.view.MenuInflater; 
import android.view.MenuItem; 
import android.view.View; 

import android.widget.TextView; 


public class MenusDemoActivity extends Activity ( 
private TextView textview; 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
textview- (TextView) findViewById (R.id.textviewl) ; 
) 
@Override 
public boolean onOptionsItemSelected (MenuItem item) { 
// TODO Auto-generated method stub 
switch (item.getItemId()) { 
case R.id.iteml: 
textview.setText ("iteml selected!") ; 
break; 
case R.id.item2: 
textview.setText ("item2 selected!") ; 
break; 
case R.id.item3: 
textview.setText ("item3 selected!") ; 
break; 
default: 
break; 


return super.onOptionsItemSelected (item) ; 
} 
@Override 
public boolean onCreateOptionsMenu (Menu menu) { 
MenuInflater inflater-getMenuInflater(); 
inflater.inflate (R.menu.mymenu, menu) ; 


return true; 


其 中 : 
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public boolean onCreateOptionsMenu (Menu menu) { 
MenuInflater inflater=getMenuInflater (); 
inflater.inflate (R.menu.mymenu, menu) ; 
return true; 


} 

这 几 行 代码 通过 Menulnflater. Inflate0 方 法 将 menu.xml 中 定义 的 菜单 项 内 容 填 充 到 了 菜单 中 。 

在 OnCreatOptionsMenu() 方 法 中 创建 菜单 时 也 支持 Menu.add0 方 法 , 也 能 达到 同样 目的 , 例如 : 

menu.add (0,itemid,0,item title) ; 

表示 在 菜单 中 添加 一 个 菜单 项 ， 该 菜单 项 的 ID 为 itemid, 菜单 项 显示 的 内 容 为 item title 的 内 
容 。 但 是 不 鼓励 使 用 这 种 方式 ， 而 应 该 使 用 XML 文件 来 创建 菜单 。 

运行 MenusDemo 实例 ， 单 击 手机 的 Menu 按钮 ， 得 到 的 效果 如 图 4.35 所 示 。 

由 运行 效果 可 见 ，MenusActivity 已 经 根据 mymenu.xml 文件 创建 了 一 个 具有 7 个 菜单 项 的 菜 
单 。 但 是 虽然 在 mymenu.xml 文件 中 为 每 个 菜单 项 指定 了 一 个 图 标 , 但 是 生成 的 选项 菜单 中 却 并 没 
有 图 标 被 显示 出 来 ， 这 是 为 什么 呢 ? 

实例 MenusDemo 当前 的 运行 环境 是 Android 4.0， 其 API Level 为 14。 我 们 先 看 一 下 ， 同 样 的 
代码 ， 在 APILevel 11 之 前 的 运行 效果 。 

双击 打开 AndroidManifest.xml 文件 ， 将 其 中 的 代码 : 


<uses-sdk android:minSdkVersion="14" /> 


改 为 : 
<uses-sdk android:minSdkVersion="9" /> 


再 次 运行 MenusDemo 实例 ， 单 击 Menu 按钮 ， 得 到 的 效果 如 图 4.36 所 示 。 





图 MenusDemo 


Menus 演 示 


menuitem 
menuitem2 
menuitem3 


menuitem4 


menuitem5 © 


menuitem menuitem2 menuitem3 


fe Ge 


menuitem4 menuitem5 More 


menuitem6 


menuitem7 





图 435 “Menu” 按 钮 运行 效果 图 4.36 API Level 11 之 前 Menu 按钮 的 运行 效果 


可 见 运行 在 早期 的 API 之 上 的 选项 菜单 效果 要 更 好 一 些 。 为 什么 会 出 现 这 种 现象 呢 ? 其 实在 
Android SDK 3.0 之 后 ， 就 不 再 鼓励 直接 使 用 选项 菜单 ， 而 是 将 选项 菜单 和 ActionBar 结合 使 用 。 
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ActionBar 又 称 活动 栏 ， 位 于 Activity 的 顶部 ， 取 代 了 原来 


标题 的 位 置 。ActionBar 中 包含 很 多 ActionItem， 相 当 于 选项 菜 | venusoemo 


单 的 菜单 项 。 将 选项 菜单 与 ActionBar 结合 的 方法 很 简单 ， 只 要 
在 XML 文件 中 添加 一 个 android:showAsAction="ifRoom" 属 性 即 
可 。 该 属性 表现 如 果 标 题 栏 有 空间 的 话 ， 就 将 相关 的 菜单 项 放 
置 到 ActionBar 中 。 如 果 标 题 栏 空间 不 足 ， 未 能 放置 到 其 中 的 菜 
单项 仍然 会 以 选项 菜单 的 形式 出 现 。ActionBar 的 运行 效果 如 图 








4.37 所 示 。 menuitem3 
menuitem4 

4.5.2 Context Menu EU 
上 下 文 菜单 注册 到 View 对 象 上 后 ， 用 户 长 按 该 View 对 象 ganana 
可 呼出 上 下 文 菜单 。 上 下 文 菜单 悬浮 于 主 界面 之 上 ， 不 支持 图 menuitem7 


标 显 示 和 快捷 键 。 其 使 用 方法 和 选项 菜单 高 度 相 似 ， 只 不 过 创 


图 4.37 ActionBar 的 运行 效果 


建 上 下 文 菜单 的 方法 为 onCreateContextMenu0， 响 应 上 下 文 菜 
单单 击 事件 的 方法 为 onContextItemSelected()。 

仍 以 工程 MenusDemo 为 例 , 为 MenusActivity 的 视图 中 的 TextView 对 象 添加 一 个 具有 两 个 菜 
单项 的 上 下 文 菜单 ， 运 行 效果 如 图 4.38 所 示 。 


上 下 文 菜单 项 一 


上 下 文 菜单 项 二 





图 4.38 两 个 上 下 文 菜单 的 运行 结果 


为 TextView 对 象 注册 上 下 文 菜单 的 代码 如 下 : 


textview= (TextView) findViewById (R.id.textviewl) ; 


registerForContextMenu (textview) ; 


创建 并 处 理 








上 下 文 菜单 单 击 事件 的 代码 如 下 : 


public boolean onContextItemSelected (MenuItem item) { 


/ 


/ TODO Auto-generated method stub 
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switch (item.getItemId()) { 
case R.id.item6: 
Log.i ("menu", "item6!") 
break; 
case R.id.item7: 
Log.i ("menu", "item]!") 


break; 
default: 
break; 
} 
return super.onContextItemSelected (item) ; 


5 
@Override 
public void onCreateContextMenu (ContextMenu menu, View v, 


ContextMenuInfo menuInfo) { 
// TODO Auto-generated method stub 
menu.add (0，R.id.item6，0，" 上 下 文 菜单 项 一 ") ; 
menu.add (0，R.id.item7，0，" 上 下 文 菜单 项 二 ") ; 
super.onCreateContextMenu (menu, v, menuInfo) ; 


4.5.3 SubMenu 


子 菜单 可 以 被 添加 到 其 他 菜单 上 ， 但 是 子 菜单 本 身 不 能 再 有 子 菜单 。 使 用 addSubMenu() 方 法 
为 MenusActivity 的 选项 菜单 添加 一 个 子 菜单 ， 运 行 效果 如 图 4.39 所 示 。 





图 4.39 添加 子 菜单 的 运行 效果 


实现 该 子 菜单 需要 重 写 onCreateOptionsMenu() 方 法 ， 代 码 如 下 : 


public boolean onCreateOptionsMenu (Menu menu) { 
MenuInflater inflater-getMenuInflater(); 
inflater.inflate (R.menu.mymenu, menu) ; 
SubMenu submenu-menu.addSubMenu (" 子 菜单 ") ; 
submenu.add (0,1,0," 子 菜单 项 一 ") ; 
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子 菜单 的 事件 处 理 代 码 在 onOptionsItemSelected0 中 实现 。 
MenusActivity.java 的 完整 代码 如 下 : 
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public boolean onCreateOptionsMenu (Menu menu) { 
MenuInflater inflater-getMenuInflater(); 
inflater.inflate (R.menu.mymenu, menu) ; 
SubMenu submenu-menu.addSubMenu (" 子 菜单 ") ; 
submenu.setIcon (android.R.drawable.ic menu crop) ; 
submenu.add (0,1, 0," FRĄM—") ; 
submenu.add (0, 2, 0, " 子 菜单 项 一 ") ; 
return true; 
} 
@Override 
public boolean onContextItemSelected (MenuItem item) { 
// TODO Auto-generated method stub 


switch (item.getItemId()) { 
case R.id.item6: 
Log.i ("menu", "item6!") ; 
break; 
case R.id.item7: 
Log.i ("menu","item7!") ; 
break; 
default: 
break; 
) 
return super.onContextItemSelected (item) ; 
k 
@Override 
public void onCreateContextMenu (ContextMenu menu, View v, 
ContextMenuInfo menuInfo) { 
// TODO Auto-generated method stub 
menu.add (0，R.id.item6，0，" 上 下 文 菜单 项 一 ") ; 
menu.add (0，R.id.item7，0，" 上 下 文 菜单 项 二 ") ; 
super.onCreateContextMenu (menu, v, menuInfo) ; 


4.6 Bitmap 


Bitmap 称 为 点 阵 图 像 或 绘制 图 像 ， 是 由 称 作 像 素 〈 图 片 元 素 ) 的 单个 点 组 成 的 ， 这 些 点 通过 
不 同 的 排列 和 染色 以 构成 图 样 。Bitmap 是 Android 系统 中 图 像 处 理 最 重要 的 类 之 一 ， 用 它 可 以 获 
取 图 像 文 件 信息 ， 对 图 像 进行 剪 切 、 旋 转 、 缩 放 等 操作 ， 并 可 以 将 图 像 保存 成 特定 格式 的 文件 。 
Bitmap 位 于 android.graphics 包 中 , 不 提供 对 外 的 构造 方法 , 只 能 通过 BitmapFactory 类 进行 实例 化 。 
利用 BitmapFactory 的 decodeFile 方法 可 以 从 特定 文件 中 获取 Bitmap 对 象 ， 也 可 以 使 用 
decodeResourceO 从 特定 的 图 片 资 源 中 获取 Bitmap 对 象 。 

实例 BitmapDemo 从 资源 文件 中 创建 Bitmap 对 象 ， 并 对 其 进行 一 些 操作 ， 运 行 效果 如 图 4.40 
所 示 。 
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图 4.40 Bitmap 对象 的 效果 


其 对 应 布局 文件 Main.xml 的 内 容 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
android: orientation="vertical"> 
<SeekBar 
android: id="@tid/seekBarId" 
android: layout_width="fill parent" 
android: layout_height="wrap content" /> 


<ImageView 
android: id="@+id/imageview" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android:src="@drawable/im01" /> 


</LinearLayout> 


BitmapDemoActivity.Java 的 代码 如 下 : 


package introduction.android.bitmapDemo; 


import com.sie.bitmapdemo.R; 

import android.app.Activity; 

import android.graphics.Bitmap; 

import android.graphics.BitmapFactory; 

import android.graphics.Matrix; 

import android.os.Bundle; 

import android.widget.ImageView; 

import android.widget.SeekBar; 

import android.widget.SeekBar.OnSeekBarChangeListener; 
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import android.widget.TextView; 


public class BitmapDemoActivity extends Activity 


1 


ImageView myImageView; 
Bitmap myBmp, newBmp; 
int bmpWidth, bmpHeight; 
SeekBar seekbarRotate; 
float rotAngle; 


@Override 
public void onCreate (Bundle savedInstanceState) 


{ 


} 


super.onCreate (savedInstanceState) ; 

setContentView (R.layout.main) ; 

myImageView- (ImageView) findViewById (R.id.imageview) ; 

// Bi Resource 载 入 图 片 

myBmp=BitmapFactory.decodeResource (getResources(), R.drawable.im01) ; 
bmpWidth-myBmp.getWidth(); 

bmpHeight=myBmp.getHeight (); 

// 实例 化 matrix 

Matrix matrix-new Matrix(); 

// 设 定 Matrix 属性 x, y 缩放 比例 为 1.5 

matrix.postScale (1.5F, 1.5F) ; 

// 顺 时 针 旋转 45 RE 

matrix.postRotate (45.0F) ; 

newBmp-Bitmap.createBitmap (myBmp, 0, 0, bmpWidth, bmpHeight, matrix, true) ; 
seekbarRotate- (SeekBar) findViewById (R.id.seekBarId) ; 
seekbarRotate.setOnSeekBarChangeListener (onRotate) ; 


private SeekBar.OnSeekBarChangeListener onRotate=new SeekBar.OnSeekBarChangeListener () { 


public void onStopTrackingTouch (SeekBar seekBar) 


t 
// TODO Auto-generated method stub 


public void onStartTrackingTouch (SeekBar seekBar) 


P 
// TODO Auto-generated method stub 


public void onProgressChanged (SeekBar seekBar, int progress, 
boolean fromUser) 


// TODO Auto-generated method stub 

Matrix m=new Matrix(); 

m.postRotate ((float) progress*3.6F) ; 

newBmp-Bitmap.createBitmap (myBmp, 0, 0, bmpWidth, bmpHeight, m, true) ; 
myImageView.setImageBitmap (newBmp) ; 
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本 实例 实现 了 拖 动 进度 条 图 片 旋转 的 效果 。 使 用 BitmapFactory 从 资源 中 载 入 图 片 ， 并 获取 图 
片 的 宽 和 高 ， 之 后 使 用 Matrix 类 对 图 片 进行 缩放 和 旋转 操作 。 


47 对 W 框 


对 话 框 是 人 机 交互 过 程 中 十 分 常见 的 组 件 ， 一 般 用 于 在 特定 条 件 下 对 用 户 显示 一 些 信 息 ， 可 
以 增强 应 用 的 友好 性 。 
Dialog 类 是 对 话 框 的 基 类 。 对 话 框 虽 然 可 以 在 界面 上 显示 ， 但 是 Dialog 不 是 View 类 的 子 类 ， 
而 是 直接 继承 自 java.lang.Object 类 。Dialog 对 象 也 有 自己 的 生命 周期 ， 其 生命 周期 由 创建 它 的 
Activity 进行 管理 。Activity 可 以 调用 showDialog (int id) 将 不 同 ID 的 对 话 框 显示 出 来 ， 也 可 以 调 
用 dismissDialog( int id) 方 法 将 ID 标识 的 对 话 框 从 用 户 界面 中 关闭 掉 。 当 Activity 调用 了 showDialog 
AD) 方法 ， 对 应 ID 的 对 话 框 没有 被 创建 时 ，Android 系统 会 回调 OnCreateDialog (ID) 方法 来 
创建 具有 该 ID 的 对 话 框 。 在 Activity 中 创建 的 对 话 框 都 会 被 Activity 保存 ， 下 次 showDialog (ID) 
方法 被 调用 时 ， 若 该 ID 的 对 话 框 已 经 被 创建 ， 则 系统 不 会 再 次 调用 OnCreateDialog (ID) 方法 创 
建 该 对 话 框 ， 而 是 会 回调 onPrepareDialog (int id, Dialog dialog) 方法 ， 该 方法 允许 对 话 框 在 被 显 
示 之 前 做 一 些 修改 。 
常用 的 对 话 框 有 AlertDialog 和 ProgressDialog, 本 节 将 通过 实例 讲解 这 两 种 对 话 框 的 使 用 方法 。 


4.7.1 AlertDialog 


AlertDialog 对 话 框 是 十 分 常用 的 用 于 显示 信息 的 方式 ， 最 多 可 提供 三 个 按钮 。AlertDialog 不 
能 直接 通过 构造 方法 构建 ， 而 要 由 AlertDialog Builder 类 来 创建 。AlertDialog 对 话 框 的 标题 、 按 钮 
以 及 按钮 要 响应 的 事件 也 由 AlertDialog.Builder 设置 。 
在 使 用 AlertDialog. Builder 创建 对 话 框 时 常用 的 几 个 方法 如 下 。 
setTitle0: 设置 对 话 框 中 的 标题 。 
setlconQ): 设置 对 话 框 中 的 图 标 。 
setMessage(): 设置 对 话 框 的 提示 信息 。 
setPositiveButton(): 为 对 话 框 添加 yes 按钮 。 
setNegativeButton0: 为 对 话 框 添加 no 按钮 。 
setNeutralButton(): 为 对 话 框 添加 第 三 个 按钮 。 


下 面 通过 实例 来 学 习 创建 AlertDialog 的 方法 。 

创建 Android 工程 DialogDemo， 并 在 main.xml 中 添加 两 个 按钮 ， 分 别 为 AlertDialog 和 
ProcessDialog. 

其 main.xml 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas. android. com/apk/res/android" 
android: layout_width="fill parent" 
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android: layout_height="fill parent" 
android: orientation="vertical"> 


<TextView 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android:text-"Dialog zv" /> 


«Button 
android:id-"&*id/buttonl" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:text-"AlertDialog" /» 


«Button 
android: id="@tid/button2" 
android: layout_width="match parent" 
android: layout_height="wrap_ content" 
android:text="ProgressDialog" /> 


</LinearLayout> 


其 运行 效果 如 图 4.41 所 示 。 
处 理 AlertDialog 按钮 单 击 事件 的 代码 为 : 
btn= (Button) findViewById (R.id.buttonl) ; 
btn.setOnClickListener (new OnClickListener()( 
@Override 
public void onClick (View v) { 


// TODO Auto-generated method stub 
showDialog (ALERT DLG) ; 


ye 


单 击 AlertDialog 按钮 ， 调 用 showDialog (ALERT DLG) ， 系 统 回 调 onCreateDialog (int id) 
方法 ， 创 建 并 弹出 AlertDialog 对 话 框 ， 如 图 4.42 所 示 。 


| oialoopemo 
Dialog 演 示 


AlertDialog 


ProgressDialog 


这 是 一 个 AlertDialog 


Negative Neutral Positive 





图 4.41 AlertDialog 的 运行 效果 图 442 单 击 AlertDialog 按钮 的 效果 
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相关 代码 为 : 


protected Dialog onCreateDialog (int id) { 

// TODO Auto-generated method stub 

Dialog dialog-null; 

switch (id) { 

case ALERT DLG: 
AlertDialog.Builder builder-new AlertDialog.Builder(DialogDemoActivity.this); 
builder.setIcon (android.R.drawable.ic dialog info) ; 
builder.setTitle ("AlertDialog") ; 
builder.setMessage (" 这 是 一 个 RlertDialog") ; 
builder.setPositiveButton ("Positive",new DialogInterface.OnClickListener () { 


@Override 

public void onClick (DialogInterface dialog, int which) { 
// TODO Auto-generated method stub 
Log.i ("DialogDemo", "OK 按钮 被 单 击 ! ") ; 


Ds 
builder.setNegativeButton ("Negative",new DialogInterface.OnClickListener()( 


@Override 
public void onClick (DialogInterface dialog, int which) { 


// TODO Auto-generated method stub 
Log.i ("DialogDemo", "Cancel 按钮 被 单 击 ! ") ; 


We 
builder.setNeutralButton ("Neutral",new DialogInterface.OnClickListener () { 


@Override 
public void onClick (DialogInterface dialog, int which) { 


// TODO Auto-generated method stub 
Log.i ("DialogDemo", "Neutral 按钮 被 单 击 ! ") ; 


ies 
dialog-builder.create(); 
break; 

default: 
break; 

) 

return dialog; 

) 


onCreateDialog() 方 法 中 创建 了 带 有 三 个 按钮 的 AlertDialog， 并 且 为 每 个 按钮 添加 了 事件 处 理 
方法 ， 以 便 获知 用 户 单 击 了 哪个 按钮 。 





4.7.2 ProgressDialog 


ProgressDialog 是 一 个 带 有 进度 条 的 对 话 框 ， 当 应 用 程序 在 完成 比较 耗 时 的 工作 时 ， 使 用 该 对 
话 框 可 以 为 用 户 提供 一 个 总 进度 上 的 提示 。 
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为 main xml 布局 中 的 ProgressDialog 按钮 添加 事件 处 理 代码 : 


progressbtn= (Button) findViewById (R.id.button2) ; 
progressbtn.setOnClickListener (new OnClickListener() { 


@override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
showDialog (PROGRESS DLG) ; 


pua 
单 击 ProgressDialog 按钮 ,调用 showDialog(PROGRESS_DLG), 系统 回调 onCreateDialog(int id) 
方法 ， 创 建 并 弹出 ProgressDialog 对 话 框 ， 如 图 4.43 所 示 。 


18% 18/100 


图 4.43 单 击 ProgressDialog 按钮 的 效果 
onCreateDialog0 方 法 中 的 相关 代码 如 下 : 


case PROGRESS_DLG: 
progressDialog-new ProgressDialog (this) ; 


// 设 置 水 平 进度 条 

progressDialog.setProgressStyle (progressDialog.STYLE HORIZONTAL) ; 
// 设 置 进度 条 最 大 值 为 100 

progressDialog.setMax (100) ; 

// 设 置 进度 条 当前 值 为 0 


progressDialog.setProgress (0) ; 
dialog=progressDialog; 
new Thread (new Runnable() { 
int count-0; 
GOverride 
public void run() { 
// TODO Auto-generated method stub 
while (progressDialog.getProgress()<100) { 
count+=3; 
progressDialog.setProgress (count) ; 
try { 
Thread.sleep (1000) ; 
} catch (InterruptedException e) { 
// TODO Auto-generated catch block 
e.printStackTrace():; 


D .start(); 
break; 
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4.8 Toast 和 Notification 


Toast 和 Notification 是 Android 系统 为 用 户 提供 的 轻 量 级 的 信息 提醒 机 制 。 这 种 方式 不 会 打 断 
用 户 当前 的 操作 ， 也 不 会 获取 到 焦点 ， 非 常 方便 。 
本 节 我 们 通过 实例 学 习 Toast 和 Notification 的 使 用 方法 。 


4.8.1 Toast 


创建 工程 NotificationDemo， 并 实现 如 图 4.44 所 示 的 布局 。 


| Notifcationpemo 


ToastKüNotification Az 


Toast 


Notification 


CancelNotification 





图 4.44 工程 布局 
main.xml 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas. android. com/apk/res/android" 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
android: orientation="vertical"> 


<TextView 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android:text="Toast M Notification HA" /> 


<Button 
android: id="@+id/button1" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android:text="Toast" /> 


<Button 
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android:id="@+id/button2" 


android: layout_width="wrap content" 


android: layout_height="wrap content" | NotificationdDemo 
android:text-"Notification" /> Toast 和 Notification 演 示 
Toast 
<Button 
android: id="@tid/button3" Notification 


android: layout_width="wrap content" 


CancelNotification 


android:layout height-"wrap content" 
android:text-"CancelNotification" /» 


</LinearLayout> 


在 NotificationDemoActivity 中 为 每 个 按钮 添加 事件 响 
应 。 单 击 Toast 按钮 ， 运 行 效果 如 图 4.45 所 示 。 Sa 
相关 代码 如 下 : 


Button toastBtn= (Button) this.findViewById 
(R.id.buttonl) ; 图 4.45 iti Toast 按钮 的 效果 
toastBtn.setOnClickListener (new 
View.OnClickListener () { 
@Override 
public void onClick (View v) ( 
// TODO Auto-generated method stub 
Toast.makeText (NotificationDemoActivity.this, "这 是 一 个 Toast im! ", 
Toast. LENGTH LONG) .show(); 
} 





Dr 

Toast 用 于 向 用 户 显示 小 信息 量 的 提示 ， 它 不 会 中 断 应 用 程序 进程 ， 不 会 对 用 户 操作 造成 任何 
干扰 ， 也 不 能 与 用 户 交 互 ， 在 信息 显示 后 会 自动 消失 。 此 处 使 用 ToastmakeText (Context context, 
CharSequence text, int duration) 方法 来 创建 一 个 Toast。 其 中 ， 
context 指 显 示 Toast 的 上 下 文 ; text 指 Toast 中 显示 的 文字 内 容 ; 
duration 指 Toast 显示 延续 的 时 间 ， 该 时 间 可 以 直接 指定 ， 也 可 以 | Notificationdemo 
使 用 Toast 提供 LENGTH LONG 和 LENGTH SHORT 常量 。 Toastf 和 Notfcato 
Toastshow() 方 法 可 以 将 Toast 对 象 显示 出 来 。Toast 默认 情况 下 显 Toast 
示 在 屏幕 的 下 方 ， 可 以 通过 ToastsetGravity() 方 法 设置 Toast 的 显 Notification 
示 位 置 。 例 如 如 下 代码 : CancelNotification 


Toast toast=Toast.makeText (NotificationDemoActivity.this, 这 是 一 个 位 于 中 间 位 置 的 Toast 


"这 是 一 个 位 于 中 间 位 置 的 Toast"， 








Toast.LENGTH LONG) ; 
toast.setGravity (Gravity.CENTER, 0, 0) ; 
toast.show(); 


显示 效果 如 图 4.46 所 示 。 





4.8.2 Notification 


图 4.46 显示 效果 


Notification 可 以 在 手机 屏幕 项 部 的 状态 栏 显示 一 个 带 图 标的 通知 ， 同 时 播放 声音 或 者 使 手机 
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fe). Notification 可 以 扩展 以 显示 详细 信息 ， 单 击 该 Notification 还 可 以 跳 转 到 特定 的 Activity。 

单 击 Notification 按钮 ， 运 行 效果 如 图 4.47 所 示 ， 在 视图 的 状态 栏 出 现 Notification 提示 。 按 
ft Notification 并 下 拉 ， 可 将 Notification 内 容 进行 扩展 ， 效 果 如 图 4.48 所 示 。 单 击 图 标 处 ， 应 用 程 
序 跳 转 到 NoteActivity 视图 ， 运 行 效果 如 图 449 所 示 。 单 击 “ 返 回 ” 按 钮 ， 返 回 到 
NotificationDemoActivity 视图 。 














z 




















H 





© 这 是 一 个 Notification | 


BB NotificationDemo 
My notification 
Toast 点 击 这 个 notification ， 可 以 跳 转 到 Note 


Notification 


CancelNotification 





图 4.47 单 击 Notification 按钮 的 效果 图 4.48 下 拉 Notification 的 效果 


BB NotificationDemo 


NoteActivity 


返回 





图 4.49 单 击 图 标的 效果 
相关 代码 如 下 : 


Button notifyBtn= (Button) this.findViewById (R.id.button2) ; 
notifyBtn.setOnClickListener (new View.OnClickListener () { 


@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
context=getApplicationContext (); 
String ns-Context.NOTIFICATION SERVICE; 
mNotificationManager- (NotificationManager) getSystemService (ns) ; 


int icon-R.drawable.icon01; 
CharSequence tickerText-"iXJÉ—4 Notification! "; 

long when-System.currentTimeMillis(); 

Notification.Builder builder-new Notification.Builder (context) ; 
builder.setSmallIcon (icon) ; 

builder.setTicker (tickerText) ; 
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builder.setWhen (when) ; 

notification-builder.getNotification(); 

CharSequence contentTitle-"My notification"; 

CharSequence contentText="##ix4 notification, FUR ES) NoteActivity."; 

Intent notificationIntent-new Intent (context, NoteActivity.class) ; 

PendingIntent contentIntent-PendingIntent.getActivity (context, 0, 
notificationIntent, 0) ; 

notification.setLatestEventInfo (context, contentTitle, contentText, 
contentIntent) ; 

notification.defaults-notification.DEFAULT SOUND; 

mNotificationManager.notify (NOTIFICATION ID, notification) ; 


Ds 


Notification.Builder 是 Android API Level 11 以 上 版 本 提供 的 Notification 的 创建 类 ， 可 以 方便 
地 创建 Notification 并 设置 各 种 属性 。 此 处 创建 了 一 个 Notification， 并 指定 了 显示 内 容 和 图 标 。 
Notification.setLatestEventInfo0 方 法 设 定 了 当 用 户 扩展 Notification 时 显示 的 样式 ， 并 通过 
PendingIntent 对 象 指 定 了 当 用 户 单 击 扩展 的 Notification 时 应 用 程序 如 何 跳 转 ， 此 处 跳 转 至 
NoteActivity. NotificationManager.notify (int id, Notification notification) 方法 为 Notification 对 象 指定 
一 个 ID 值 ， 并 将 该 Notification 对 象 显 示 到 状态 栏 上 。NotificationManager.cancel (int id) 方法 会 
将 ID 指向 的 Notification 对 象 取消 掉 。 

NoteActivity java 的 代码 如 下 : 


package introduction.android.notificationDemo; 


import android.app.Activity; 
import android.content. Intent; 
import android.os.Bundle; 
import android.view.View; 
import android.widget.Button; 


public class NoteActivity extends Activity { 
private Button btn; 


public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.other) ; 
btn- (Button) this.findViewById (R.id.buttonl) ; 
btn.setOnClickListener (new View.OnClickListener () { 


@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
Intent intent=new Intent 
(NoteActivity.this, NotificationDemoActivity.class) ; 
startActivity (intent) ; 


Ds 
} 


NoteActivity 所 使 用 的 布局 文件 otherxml 的 代码 如 下 : 
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<?xml version-"1.0" encoding-"utf-8"2» 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:orientation-"vertical"» 


<TextView 
android: id="@+id/textViewl” 
android: layout_width="wrap content" 
android:layout height-"wrap content" 
android:text-"NoteActivity" /> 


«Button 
android: id="@+id/button1" 
android: layout_width="wrap content" 
android:layout height-"wrap content" 
android: text=" A" /> 


</LinearLayout> 


4.8.3 Notification Group 


当 一 个 应 用 程序 产生 多 个 通知 时 ，Android N 提供 了 新 的 API， 支 持 将 多 个 通知 进行 分 组 和 折 
登 显 示 ， 同 时 告诉 用 户 共有 多 少 个 通知 ， 并 且 给 出 一 个 关于 通知 的 摘要 消息 。 实 例 NotiDemo 演示 
了 这 一 功能 ， 其 界面 很 简单 ， 布 局 如 图 4.50 所 示 。 当 每 次 点 击 NOTIFY 按钮 时 ， 该 应 用 会 产生 一 
个 通知 消息 ， 而 按钮 下 方 的 TextView 会 显示 当前 应 用 共产 生 了 多 少 个 通知 。 


Android Emulat 


NotiDemo 











图 4.50 NotiDemo 布局 


该 布局 对 应 内 容 为 : 


<?xml version="1.0" encoding="utf-8"?> 
<RelativeLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
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android:id="@+id/activity main" 
android:layout width-"match parent" 

android:layout height-"match parent" 
android:paddingBottom="@dimen/activity vertical margin" 
android:paddingLeft="@dimen/activity horizontal margin" 
android:paddingRight="@dimen/activity horizontal margin" 
android:paddingTop-"édimen/activity vertical margin" 
tools:context-"introduction.android.notidemo.MainActivity"» 


<TextView 
android: layout_width="wrap_ content" 
android: layout_height="wrap_ content" 
android:text="Hello World!" /> 





<Button 
android: text="Notify” 
android: layout_width="wrap_ content" 
android: layout_height="wrap_ content" 
android: layout_below="@+id/textView” 
android: layout_alignParentStart="true”" 
android: layout_marginStart="52dp" 
android: layout_marginTop="38dp" 
android:id="@+id/button" /> 


<TextView 

android: text="TextView” 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:layout marginTop-"36dp" 
android:id-"Grid/number of notifications" 
android: layout_below="@+id/button" 
android: layout_centerHorizontal="true" /> 

</RelativeLayout> 


MainActivity.java 的 代码 为 : 


package introduction.android.notidemo; 


import android.app.Activity; 

import android.app.Notification; 

import android.app.NotificationManager; 

import android.content.Context; 

import android.os.Bundle; 

import android.service.notification.StatusBarNotification; 
import android.support.v4.app.NotificationCompat; 
import android.util.Log; 

import android.view.View; 

import android.widget.Button; 

import android.widget.TextView; 


public class MainActivity extends Activity ( 
private static final int REQUEST CODE = 2323; 


private static final String TAG - "NotiDemo"; 
private static final String NOTIFICATION GROUP -"intoduction.android.notidemo.group"; 
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private static final int NOTIFICATION GROUP SUMMARY ID = 1; 

private TextView mNumberOfNotifications; 

private NotificationManager mNotificationManager; 

private static int sNotificationId - NOTIFICATION GROUP SUMMARY ID * 1; 
Override 

protected void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState) ; 
setContentView(R.layout.activity main); 
mNotificationManager - (NotificationManager) getSystemService( 
Context.NOTIFICATION SERVICE); 
mNumberOfNotifications - (TextView)findViewById(R.id.number of notifications); 
Button btn- (Button) findViewById(R.id.button); 
btn.setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View view) { 
addNotificationAndUpdateSummaries(); 


n; 


private void addNotificationAndUpdateSummaries() { 


// [BEGIN create notification] 

// Create a Notification and notify the system. 

final NotificationCompat.Builder builder - new NotificationCompat.Builder (this) 
-setSmalllIcon(R.mipmap.ic notification) 
-setContentTitle(getString(R.string.app_name) ) 
-setContentText (getString(R.string.sample notification content)) 
.setAutoCancel (true) 
.setGroup (NOTIFICATION GROUP); 


final Notification notification = builder.build(); 
mNotificationManager.notify (getNewNotificationId(), notification); 
// [END create notification] 

Log.i(TAG, "Add a notification"); 

updateNotificationSummary(); 

updateNumberOfNotifications(); 


* Adds/updates/removes the notification summary as necessary. 


protected void updateNotificationSummary() { 


int numberOfNotifications - getNumberOfNotifications(); 


if (numberOfNotifications » 1) ( 
// Add/update the notification summary. 


String notificationContent - getString(R.string.sample notification summary content, 


numberOfNotifications); 
final NotificationCompat.Builder builder - new NotificationCompat.Builder (this) 
-setSmalllIcon(R.mipmap.ic notification) 
.setStyle(new NotificationCompat.BigTextStyle() 
-setSummaryText (notificationContent)) 
. setGroup (NOTIFICATION GROUP) 
-setGroupSummary (true); 
final Notification notification = builder.build(); 
mNotificationManager.notify (NOTIFICATION GROUP SUMMARY ID, notification); 
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) 


) else ( 
// Remove the notification summary. 
mNotificationManager.cancel(NOTIFICATION GROUP SUMMARY ID); 


[ee 
* Requests the current number of notifications from the {@link NotificationManager} and 
* display them to the user. 
8p 

protected void updateNumberOfNotifications() ( 

final int numberOfNotifications = getNumberOfNotifications(); 

mNumberOfNotifications.setText (getString(R.string.active notifications, 
numberOfNotifications)); 

Log.i(TAG, getString(R.string.active notifications, numberOfNotifications)); 


[ee 
* Retrieves a unique notification ID. 
ay; 
public int getNewNotificationId() { 
int notificationId = sNotificationId++; 


// Unlikely in the sample, but the int will overflow if used enough so we skip the summary 
// ID. Most apps will prefer a more deterministic way of identifying an ID such as hashing 
// the content of the notification. 
if (notificationId == NOTIFICATION GROUP SUMMARY ID) { 

notificationId = sNotificationIdtt; 


} 


return notificationId; 


private int getNumberOfNotifications() { 
// [BEGIN get active notifications] 
// Query the currently displayed notifications. 
final StatusBarNotification[] activeNotifications = mNotificationManager 
-getActiveNotifications(); 
// [END get active notifications] 


// Since the notifications might include a summary notification remove it from the count if 
// it is present. 
for (StatusBarNotification notification : activeNotifications) ( 
if (notification.getId() == NOTIFICATION GROUP SUMMARY ID) { 
return activeNotifications.length - 1; 


i 
return activeNotifications.length; 


对 应 的 strings.xml 代码 为 : 


<resources> 


<string name="app_name">NotiDemo</string> 
«string name="active_notifications"> 目 前 的 通知 数目 : %1$d</string> 
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«string name-"sample notification _content"> 这 是 一 个 通知 的 示例 。</string> 
«string name-"sample notification summary content"»3ifj sd 个 通知 。</string> 


</resources> 


I; NOTIFY 按钮 ， 运 行 效果 如 图 4.51 所 示 。 


Android Emulator - APIZ- 








NotiDemo 


目前 的 通知 数目 : 10 





图 4.51 运行 效果 


Android N 通过 NotificationCompat 类 构建 通知 的 模板 信息 ， 例 如 通知 的 图 标 、 通 知 的 标题 、 
通知 的 内 容 、 通 知 是 否 需 要 进行 分 组 等 ， 然 后 由 NotificationCompat 构建 Notification 通知 对 象 ， 并 
由 NotificationManager 发 送 通知 。 相 关 代码 如 下 : 


final NotificationCompat.Builder builder = new NotificationCompat.Builder(this) 
.setSmallIcon(R.mipmap.ic_notification) 
-setContentTitle(getString(R.string.app_name) ) 
-setContentText (getString(R.string.sample_notification_content) ) 
-setAutoCancel (true) 
.SetGroup (NOTIFICATION_GROUP) ; 

final Notification notification = builder.build(); 

mNotificationManager.notify (getNewNotificationId(), notification); 


在 设置 了 通知 分 组 的 情况 下 ，Android N 会 自动 将 同一 个 应 用 的 通知 进行 合并 分 组 实现 ， 
Android N 可 以 通过 NotificationCompat 设置 通知 分 组 的 显示 消息 。 


String notificationContent = getString(R.string.sample notification summary content, 
numberOfNotifications) ; 
final NotificationCompat.Builder builder = new NotificationCompat.Builder (this) 
-setSmallIcon(R.mipmap.ic notification) 
.setStyle(new NotificationCompat.BigTextStyle() 
-setSummaryText (notificationContent)) 
-setGroup (NOTIFICATION GROUP) 
-setGroupSummary (true); 


SR ULT. SAVE ZA RI EAA. SCENE REN, Z BS A CUTE. 
并 以 “+ 折 对 通知 数目 ”的 方式 进行 显示 ， 如 图 4.52 所 示 。 





M 
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将 折 对 效果 下 的 通知 分 组 下 拉 ， 会 得 到 非 折 对 效果 的 通知 列表 ， 如 图 4.53 所 示 。 而 这 也 是 不 
进行 通知 分 组 折合 时 的 效果 ， 即 NotificationCompat 不 进行 setGroup 设置 时 的 效果 。 


Android Emulator - API24:5554 












Android Emulator - API24:5554 


Wl NouDemo . 共有 10 4380 
NotiDemo 这 是 一 个 通知 的 示例 . 


NotiDemo 这 是 一 个 
NotiDemo 这 是 一 个 






NotiDemo 
这 是 一 个 通知 的 示例 


CLEAR ALL 


NotiDemo 
这 是 一 个 通知 的 示例 








图 4.52 ”通知 分 组 和 折 营 效果 图 4.53 非 折 释 的 通知 列表 
4.9 多 窗口 模式 


Android N 支持 多 窗口 模式 ， 或 者 叫 分 屏 模式 ， 即 在 屏幕 上 可 以 同时 显示 多 个 窗口 。 在 手机 模 
式 下 ， 两 个 应 用 可 以 并 排 或 者 上 下 同时 显示 ， 如 图 4.54 所 示 ， 
屏幕 上 半 部 分 的 窗口 是 系统 的 CLOCK 应 用 , 下 半 部 分 是 系统 设 


置 功能 。 用 户 可 以 拖 动 两 个 应 用 之 间 的 分 界线 改变 两 个 窗口 的 大 S 
小 ， 放 大 其 中 一 个 应 用 ， 同 时 缩小 另 一 个 应 用 。 在 电视 设备 上 ， 

可 以 实现 “ 画 中 画 ” 功 能。 在 分 屏 模式 下 ， 各 个 窗口 的 应 用 都 可 

以 正常 运行 , 但 是 只 能 有 一 个 窗口 获得 焦点 , 而 另外 的 窗口 则 属 5,50 AM * 

于 暂停 状态 。 


Mon, Tue, Wecehu, Fri v 
+ 


Android N 用 户 可 以 通过 以 下 方式 切换 到 多 窗口 模式 : 


(1) 用 户 打 开 Overview 屏幕 并 长 按 Activity 标题 , 可 以 
拖 动 该 Activity 至 屏幕 突出 显示 的 区 域 ， 使 Activity 进入 多 窗 


Suggestions (2) A 
模式 。 


Settings 





























(2) 用 户 长 按 Overview 按钮 ， 设 备 上 当前 的 Activity 将 @  Soreenlock — 
进入 多 窗口 模式 ， 同 时 将 打开 Overview 屏幕 ,用户 可 在 该 屏幕 ERE 
中 选择 要 共享 屏幕 的 另 一 个 Activity。 a Change wallpaper 


Personalize your screen 


用 户 可 以 在 两 个 Activity 共享 屏幕 的 同时 在 这 两 个 图 4.54 分 屏 模式 
Activity 之 间 拖 放 数据 。 
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默认 情况 下 ，Android N 的 Activity 都 是 开启 多 窗口 模式 的 。 例 如 ， 我 们 通过 Android Studio 
构建 一 个 默认 的 空 Activity 应 用 MultiScreenDemo， 无 须 做 任何 修改 ， 该 Activity 即 可 使 用 多 窗口 
模式 ， 运 行 效果 如 图 4.55 所 示 。 





Android Emulator - API24:5554 





MultiSceenDemo 


图 4.55” 自 开发 应 用 的 多 窗口 模式 
我 们 在 MainActivity 上 添加 一 个 按钮 ， 并 实现 点 击 打开 第 二 个 Activity 的 功能 ， 代 码 如 下 : 


public class MainActivity extends Activity { 
@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 
Button btn=findViewById(R.id.button) ; 
btn.setOnClickListener (new View.OnClickListener() { 
@Override 
public void onClick(View view) { 
Intent intent-new Intent (MainActivity.this,Main2Activity.class); 
startActivity (intent); 


n: 
i} 
点 击 “ 新 窗口 ”按钮 后 ， 第 二 个 窗口 会 被 创建 ， 并 覆盖 掉 第 一 个 窗口 ， 如 图 4.56 所 示 。 
默认 情况 下 ， 同 一 个 应 用 的 多 个 Activity 会 共用 同一 个 窗口 ， 且 无 法 分 配 到 不 同窗 口中 。 若 希 
望 同一 个 应 用 的 不 同窗 体 可 以 被 分 配 到 不 同窗 口中 ， 需 要 在 启动 新 窗 体 时 给 Intent 设置 一 个 
FLAG ACTIVITY LAUNCH ADJACENT 标志 ， 这 样 新 Activity 就 会 在 新 的 栈 中 被 启动 ， 独 立 于 
原来 的 Activity， 进 而 实现 两 个 Activity 被 放置 于 不 同 的 窗口 中 ， 如 图 4.57 所 示 。 
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Android Emulator - API24:5554 Android Emulator - API24:5554 





Main2Activity 


Main2Activity MultiSceenDemo 





图 4.56 ”新 窗口 图 4.57 同一 应 用 的 两 个 窗口 
关键 代码 如 下 : 


Intent intent=new Intent (MainActivity.this,Main2Activity.class); 


intent.setFlags(Intent.FLAG ACTIVITY LAUNCH ADJACENT|Intent.FLAG ACTIVITY NEW TASK); 


持 ， 


和 最 


startActivity (intent); 


Android N 系统 为 Activity 增添 了 <layout> 清单 元 素 对 Activity 在 多 窗口 模式 中 的 行为 进行 支 
包括 以 下 几 种 属性 : 


* android:defaultWidth， 以 自由 形状 模式 启动 时 Activity 的 默认 宽度 。 

© android:defaultHeight， 以 自由 形状 模式 启动 时 Activity 的 默认 高 度 。 

* android:gravity， 以 自由 形状 模式 启动 时 Activity 的 初始 位 置 。 请 参阅 Gravity 的 参考 资料 ， 
了 解 合适 的 值 进行 设置 。 

* android:minimalHeight、android:minimalWidth， 分 屏 和 自由 形状 模式 中 Activity 的 最 小 高 度 
和 最 小 宽度 。 如 果 用 户 在 分 屏 模式 中 移动 分 界线 ， 使 Activity 尺寸 低 于 指定 的 最 小 值 ， 系 统 
会 将 Activity 裁剪 为 用 户 请 求 的 尺寸 。 


例如 ， 以 下 代码 显示 了 如 何 指定 Activity 在 自由 形状 模式 显示 时 Activity 的 默认 大 小 、 位 置 
小 尺寸 : 


<activity android:name=".MYRctivity"> 
<layout android:defaultHeight="500dp" 
android: defaultWidth="600dp" 
android: gravity="top|end" 
android:minimalHeight="450dp" 
android:minimalWidth="300dp" /> 
</activity> 


如 果 不 想 让 Activity 使 用 多 窗口 模式 ， 只 需要 在 清单 文件 中 为 Activity 节点 设置 : 
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android: resizeableActivity="false” 


此 属性 设置 为 false，Activity 将 不 支持 多 窗口 模式 。 在 该 值 为 false 的 情况 下 ， 如 果 用 户 尝试 
在 多 窗口 模式 下 启动 Activity， 该 Activity 将 全 屏 显示 。 各 位 读者 可 以 自行 尝试 。 


410 “界面 事件 响应 


事件 是 Android 平台 与 用 户 交 互 的 手段 。 当 用 户 对 手机 进行 操作 时 , 会 产生 各 种 各 样 的 输入 事 
件 ，Android 框架 捕获 到 这 些 事件 ， 进 而 进行 处 理 。Android 平台 提供 了 多 种 用 于 获取 用 户 输入 事 
件 的 方式 ， 考 虑 到 用 户 事件 都 是 在 特定 的 用 户 界面 中 产生 的 ， 因 此 Android 选用 特定 View 组 件 来 
获取 用 户 输入 事件 的 方式 ， 由 View 组 件 提供 事件 的 处 理 方法 。 这 就 是 为 什么 View 类 内 部 带 有 处 
理 特定 事件 的 监听 器 。 





4.10.1 事件 监听 器 


监听 器 用 于 对 特定 事件 进行 监听 ， 一 旦 监听 到 特定 事件 ， 则 由 监听 器 截获 该 事件 ， 并 回调 自 
身 的 特定 方法 对 事件 进行 处 理 。 在 本 章 之 前 的 实例 中 , 我 们 使 用 的 事件 处 理 方式 都 是 监听 器 。 根 据 
用 户 输入 方式 的 不 同 ，View 组 件 将 截获 的 事件 分 为 6 种 ， 对 应 以 下 6 种 事件 监听 器 接口 。 


(1) OnClickListener 接口 : 此 接口 处 理 的 是 单 击 事件 ， 例 如 ， 在 View 上 进行 单 击 动作 ， 在 
View 获得 焦点 的 情况 下 单 击 “ 确 定 ” 按 钮 或 者 单 击 轨迹 球 都 会 触发 该 事件 。 当 单 击 事件 发 生 时 ， 
OnClickListener 接口 会 回调 public void onClick (View v) 方法 对 事件 进行 处 理 。 其 中 参数 v 指 的 是 
发 生 单 击 事件 的 View 组 件 。 

(2) OnLongClickListener 接口 : 此 接口 处 理 的 是 长 按 事 件 ， 当 长 时 间 按 住 某 个 View 组 件 时 
触发 该 事件 。 其 对 应 的 回调 方法 为 public boolean onLongClick (View v) ， 当 返回 true 时 ， 表 示 已 
经 处 理 完 此 事件 ， 若 事件 未 处 理 完 ， 则 返回 false， 该 事件 还 可 以 继续 被 其 他 监听 器 捕获 并 处 理 。 

(3) OnFocusChangeListener 接口 : 此 接口 用 于 处 理 View 组 件 焦点 改变 事件 。 当 View 组 件 
失去 或 获得 焦点 时 会 触发 该 事件 , 其 对 应 的 回调 方法 为 public void onFocusChange ( View v, Boolean 
hasFocus) ， 其 中 参数 v 表示 产生 事件 的 事件 源 ，hasFocus 表示 事件 源 的 状态 ， 即 是 否 获得 焦点 。 














被 敲 击 时 会 触发 该 事件 。 其 对 应 的 回调 方法 为 public boolean onKey (View v, int keyCode, KeyEvent 
event) ， 其 中 参数 keyCode 为 键盘 码 ， 参 数 event 为 键盘 事件 封装 类 的 对 象 。 

(5) OnTouchListener 接口 : 此 接口 用 来 处 理 手机 屏幕 事件 ， 当 在 View 的 范围 内 有 触摸 、 按 
下 、 抬 起 、 滑动 等 动作 时 都 会 触发 该 事件 , 并 触发 该 接口 中 的 回调 方法 , 其 对 应 的 回调 方法 为 public 
boolean onTouch (View v, MotionEvent event) ， 对 应 的 参数 同上 。 

(6) OnCreateContextMenuListener 接口 : 此 接口 用 于 处 理 上 下 文 菜单 被 创建 的 事件 ， 其 对 应 
的 回调 方法 为 public void onCreateContextMenu( ContextMenu menu, View v, ContextMenulnfo info), 
其 中 参数 menu 为 事件 的 上 下 文 菜单 ,参数 info 是 该 对 象 中 封装 了 有 关上 下 文 菜 单 的 其 他 信息 。 TE 
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4.5 节 的 实例 MenusDemo 中 ， 创 建 上 下 文 菜单 使 用 的 是 registerForContextMenu (View v) 方法 ， 
其 本 质 是 为 View 组 件 注册 该 接口 ， 并 实现 了 相应 的 回调 方法 。 


410.2 回调 事件 响应 


在 Android 框架 中 , 除了 可 以 使 用 监听 器 进行 事件 处 理 之 外 , 还 可 以 通过 回调 机 制 进行 事件 处 
理 。Android SDK 为 View 组 件 提供 了 5 个 默认 的 回调 方法 ， 如 果 某 个 事件 没有 被 任意 一 个 View 
处 理 ， 就 会 在 Activity 中 调用 响应 的 回调 方法 ， 这 些 方法 分 别 说 明 如 下 。 


(1) public boolean onKeyDown (int keyCode, KeyEvent event) 方法 是 接口 KeyEvent. Callback 
中 的 抽象 方法 ， 当 键盘 按键 被 按 下 时 由 系统 调用 。 参 数 keyCode 即 键盘 码 ， 系 统 根据 键盘 码 得 知 
按 下 的 是 哪个 按钮 。 参 数 event 为 按钮 事件 的 对 象 ， 包 含 触发 事件 的 详细 信息 ， 例 如 事件 的 类 型 、 
状态 等 。 当 此 方法 的 返回 值 为 True 时 ,代表 已 完成 处 理 此 事件 ， 返 回 false 表示 该 事件 还 可 以 被 其 
他 监听 器 处 理 。 

(2) public boolean onKeyUp (int keyCode, KeyEvent event) 方法 也 是 接口 KeyEvent. Callback 
中 的 抽象 方法 ， 当 按钮 向 上 弹 起 时 被 调用 ， 参 数 与 onKeyDown0 完 全 相同 。 

(3) public boolean onTouchEvent (MotionEvent event) 方法 在 View 中 定义 ， 当 用 户 触摸 屏 
幕 时 被 自动 调用 。 参 数 event 为 触摸 事件 封装 类 的 对 象 ， 封 装 了 该 事件 的 相关 信息 。 当 用 户 触摸 到 
屏幕 ， 屏 幕 被 按 下 时 ，MotionEvent.getAction0 的 值 为 MotionEvent.ACTION_DOWN; 当 用 户 将 触 
控 物 体 离开 屏幕 时 ，MotionEvent.getAction0 的 值 为 MotionEvent. ACTION UP; 当 触 控 物 体 在 屏幕 
上 滑动 时 ，MotionEvent.getAction0) 的 值 为 MotionEvent. ACTION MOVE. onTouchEvent 方法 的 返 
HEA true 表示 事件 处 理 完成 ， 返 回 false 表示 未 完成 。 

(4) public boolean onTrackballEvent (MotionEvent event) 方法 的 功能 是 处 理 手机 中 轨迹 球 的 
相关 事件 ， 可 以 在 Activity 中 重 写 ， 也 可 以 在 View 中 重 写 。 参 数 event 为 手机 轨迹 球 事件 封装 类 
的 对 象 。 该 方法 的 返回 值 为 rue 表示 事件 处 理 完成 ， 返 回 值 为 false 表示 未 完成 。 

(5) protected void onFocusChanged (boolean gainFocus, int direction, Rect previouslyFocusedRect) 
方法 只 能 在 View 中 重 写 , “4 View 组 件 焦点 改变 时 被 自动 调用 , 参数 gainFocus 表示 触发 该 事件 的 
View 是 否 获得 了 焦点 ， 获 得 焦点 为 tue, SAR direction 表示 焦点 移动 的 方向 ， 参 数 
previouslyFocusedRect 是 在 触发 事件 的 View 的 坐标 系 中 前 一 个 获得 焦点 的 矩形 区 域 。 











410.3 界面 事件 响应 实例 


在 之 前 的 章节 中 ， 多 次 使 用 监听 器 对 事件 进行 处 理 ， 读 者 应 该 已 经 很 熟悉 了 。 本 节 通 过 一 个 
实例 来 演示 回调 事件 响应 的 处 理 过程 ， 该 实例 EventDemo 的 运行 效果 如 图 4.58 所 示 。 
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Fd4.58 ”实例 EventDemo 的 运行 效果 
其 布局 文件 main.xml 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
android: orientation="vertical"> 


<TextView 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android: text=" WHHL" /> 
<LinearLayout 
android:layout_width="wrap content" 
android:layout_height="wrap content" 
android:orientation="horizontal"> 
<Button 
android:id="@+id/button1" 
android:layout_width="wrap content" 
android:layout_height="wrap content" 
android:focusableInTouchMode="true" 
android:text-"ffff 1"/> 
<Button 
android:id="@+id/button2" 
android:layout_width="wrap content" 
android:layout_height="wrap_content" 
android:focusableInTouchMode="true" 
android: text=" #4 2"/> 
<Button 
android:id="@+id/button3" 
android:layout_width="wrap content" 
android:layout height-"wrap content" 
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android: focusableInTouchMode="true” 
android:text-" Aff 3"/> 
</LinearLayout> 


</LinearLayout> 


当 用 户 在 屏幕 上 做 移动 触摸 、 单 击 按钮 等 操作 时 ， 主 Activity EventDemo 会 捕获 相应 事件 并 
行 处 理 ， 在 LogCat 中 打印 相关 内 容 ， 运 行 效果 如 图 4.59 所 示 。 








Application Tag Text 
introduction.android.eventDemo enentDemo 第 一 个 按钮 获得 了 焦点 
introduction.android.eventDemo enentDemo 第 二 个 接 钮 获得 了 焦点 
introduction.android.eventDemo enentDemo 手指 正在 往 屏 莫 上 技 下 
introduction.android.eventDemo enentDemo 季 指 正在 屏幕 上 移动 
introduction.android.eventDemo enentDemo 手指 正在 屏 莫 上 移动 
introduction.android.eventDemo enentDemo 手指 正在 屏 莫 上 移动 
introduction.android.eventDemo enentDemo 手指 正在 屏幕 上 移动 
introduction.android.eventDemo enentDemo 手指 正在 屏 莫 上 移动 
introduction. android.eventDemo enentDemo 手指 正在 屏幕 上 移动 
introduction.android.eventDemo enentDemo 手指 正在 从 屏幕 上 拍 起 








图 4.59 Activity EventDemo 捕获 事件 


EventDemo.java 代码 如 下 : 


package introduction.android.eventDemo; 


import android.app.Activity; 
import android.content.Context; 
import android.graphics.Rect; 
import android.os.Bundle; 

import android.util.Log; 

import android.view.KeyEvent; 
import android.view.MotionEvent; 
import android.view.View; 

import android.view.View.OnFocusChangeListener; 
import android.widget.Button; 
import android.widget.Toast; 


public class EventDemo extends Activity implements OnFocusChangeListener { 

Button[] buttons-new Button[3]; 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
buttons[0]- (Button) findViewById (R.id.buttonl) ; 
buttons[1]- (Button) findViewById (R.id.button2) ; 
buttons[2]- (Button) findViewById (R.id.button3) ; 
for (Button button :buttons) { 

button.setOnFocusChangeListener (this) ; 





H 
// 按 钮 按 下 触发 的 事件 


public boolean onKeyDown (int keyCode,KeyEvent event) 
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case R.id.button3: 
DisplayInformation ("第 三 个 按钮 获得 了 焦点 ") ; 


break; 
5 
5 


//Skzs Toast. 
public void DisplayInformation (String string) 
t 
//Toast.makeText (EventDemo.this,string,Toast.LENGTH SHORT) .show(); 
Log.i ("enentDemo",string) ; 


} 


4.10 小 结 


本 章 介 绍 了 使 用 Android SDK 进行 用 户 界 面 设 计 开发 过 程 中 涉及 的 相关 知识 ， 介 绍 了 常用 的 
Widget 组 件 及 布局 的 使 用 方法 , 菜单 (Menu) 和 活动 栏 (ActionBar) 结合 使 用 的 方法 ，AlertDialog 
和 ProgressDialog 对 话 框 的 使 用 方法 ，Toast 和 Notification 的 使 用 方法 。 每 一 部 分 都 辅 以 实例 ， 希 
望 可 以 帮助 读者 掌握 进行 各 个 组 件 的 使 用 方法 ， 以 后 在 Android UI 的 设计 中 能 够 有 游 丸 有余。 本 
章 最 后 简单 介绍 了 Android 系统 框架 提供 的 组 件 与 用 户 之 间 的 交互 事件 的 两 种 处 理 方法 , 分 别 为 事 
件 监听 器 和 系统 回调 方法 。 

由 于 篇 幅 有 限 ， 在 本 章 中 不 可 能 对 用 户 界 面 设计 中 涉及 的 所 有 组 件 进行 全 面 介绍 ， 读 者 可 以 
参阅 Android SDK 文档 获取 更 多 的 知识 。 





1. 为 什么 要 使 用 布局 ? 

2. 使 用 TextView、EditText 和 Button 组 件 实现 一 个 简单 的 计算 器 。 

3. 实现 一 个 输入 密码 框 。 在 EditText 中 输入 密码 ， 当 输入 密码 时 显示 “@”， 在 下 方 添加 一 
个 CheckBox 用 来 选择 是 否 “显示 密码 ”。 

4. 举例 说 明 CheckBox 与 RadioGroup 的 区 别 有 哪 些 。 





电话 和 短信 应 用 程序 开发 


手机 的 基本 功能 是 打 电话 和 发 短信 。 本章 通过 Intent 的 使 用 来 介绍 在 Android 系统 下 如 何 对 电 
话 和 短信 应 用 程序 进行 开发 。 通 过 Intent， 程 序 员 可 以 方便 地 将 自己 开发 的 应 用 程序 与 手机 中 的 其 
他 应 用 组 件 进行 交互 。 


5.1 Intent 


Intent 被 译作 “意图 ”， 在 Android 中 提供 了 Intent 机 制 来 协助 应 用 间 的 交互 与 通信 。Intent 
负责 对 应 用 中 一 次 操作 的 动作 、 动 作 涉 及 数据 、 附 加 数据 进行 描述 ，Android 则 根据 此 Intent 的 描 
述 ， 负 责 找 到 对 应 的 组 件 ， 将 Intent 传递 给 调用 的 组 件 ， 并 完成 组 件 的 调用 。Intent 不 仅 可 用 于 应 
用 程序 之 间 ， 也 可 用 于 应 用 程序 内 部 Activity/Service 之 间 的 交互 。 因 此 ， 可 以 将 Intent 理解 为 不 同 
组 件 之 间 通 信 的 “媒介 ”， 专 门 提供 组 件 互 相 调用 的 相关 信息 。 

Intent 是 对 它 要 完成 的 动作 的 一 种 抽象 描述 , Intent 封装 了 它 要 执行 动作 的 属性 :Action( 动 作 )、 
Data CHE) ~ Category (KG) ~ Type (CA!) . Component (组 件 信息 ) 和 Extras( 附 加 信息 〉。 

1. Action 


Action 是 指 Intent 要 实施 的 动作 ， 是 一 个 字符 串 常量 。 如 果 指 明了 一 个 Action， 执 行者 就 会 依 
照 这 个 动作 的 指示 ， 接 收 相关 输入 ， 表 现 对 应 行为 ， 产 生 符 合 条 件 的 输出 。 
在 Intent 类 中 定义 了 大 量 的 Action 常量 属性 ， 标 准 的 Activity Actions 如 表 5.1 所 示 。 


表 5.1 标准 的 Activity Actions 








动作 名 称 动作 功能 
ACTION MAIN 作为 一 个 主要 的 进入 口 ， 而 并 不 期 望 去 接收 数据 














ACTION VIEW 向 用 户 显示 数据 
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( 续 表 ) 

动作 名 称 动作 功能 
ACTION ATTACH DATA 用 于 指定 一 些 数据 应 该 附属 于 哪些 地 方 ， 例 如 ， 图 片 数 据 应 该 附属 于 联系 人 
ACTION EDIT 访问 已 给 的 数据 ， 提 供 明确 的 可 编辑 接口 
ACTION PICK 从 数据 中 选择 一 个 子 项 目 ， 并 返回 所 选中 的 项 目 
ACTION CHOOSER 显示 一 个 Activity 选择 器 ， 人 允许 用 户 在 进程 之 前 选择 他 们 想 要 的 

人 允许 用 户 选 择 特殊 种 类 的 数据 ， 并 返回 〈 特 殊 种 类 的 数据 : 照 一 张 相片 或 录 一 
ACTION_GET_CONTENT B) 
ACTION DIAL 拨打 一 个 指定 的 号 码 ， 显 示 一 个 带 有 号 码 的 用 户 界 面 ， 允 许 用 户 去 启动 呼叫 
ACTION CALL 根据 指定 的 数据 执行 一 次 呼叫 
ACTION SEND 传递 数据 ， 被 传送 的 数据 没有 指定 
ACTION_SENDTO 发 送 一 个 信息 到 某 个 指定 的 人 
ACTION_ANSWER 处 理 一 个 打 进 电话 呼叫 
ACTION_INSERT 插入 一 条 空 项 目 到 已 给 的 容器 
ACTION DELETE 从 容器 中 删除 已 给 的 数据 
ACTION RUN 运行 数据 
ACTION SYNC 同步 执行 一 个 数据 
ACTION PICK ACTIVITY 为 已 知 的 Intent 选择 一 个 Activity， 返 回 被 选中 的 类 
ACTION SEARCH 执行 一 次 搜索 
ACTION WEB SEARCH 执行 一 次 Web 搜索 
ACTION FACTORY TEST 工厂 测试 的 主要 进入 点 








2. Data 
Intent 的 Data 属性 是 执行 动作 的 URI 和 MIME 类 型 ， 不 同 的 Action 有 不 同 的 Data 数据 指定 。 
例如 ， 通 讯 录 中 identifier 为 1 的 联系 人 的 信息 (一般 以 可 形式 描述 ) ,给 这 个 人 打 电 话 的 语句 为 : 


ACTION VIEW content://contacts/1 
ACTION_DIAL content://contacts/1 


3. Category 

Intent 中 的 Category 属性 起 着 对 Action 补充 说 明 的 作用 。 通 过 Action, 配合 Data 或 Type 可 以 
准确 表达 出 一 个 完整 的 意图 (加 一 些 约束 会 更 精准 ) 。Intent 中 的 Category 属性 用 于 执行 Action 
的 附加 信息 。 例 如 ，CATEGORY_LAUNCHER 表示 加 载 程序 时 Activity 出 现在 最 上 面 ，HOME 
表示 回 到 Home 界面 。 

4. Type 

Intent 的 Type 属性 显示 指定 Intent 的 数据 类 型 (MIME) 。 通 常 Intent 的 数据 类 型 可 以 从 Data 
自身 判断 出 来 ， 但 是 一 旦 指定 了 Type 类 型 ， 就 会 强制 使 用 Type 指定 的 类 型 而 不 再 进行 推导 。 

5. Component 

Intent 的 Compotent 属性 指定 Intent 的 目标 组 件 的 类 名 称 。 通 常情 况 下 ，Android 会 根据 Intent 
中 包含 的 其 他 属性 的 信息 进行 查找 ， 比 如 用 Action, Data. Type. Category 去 描述 一 个 请 求 ， 这 种 
模式 称 为 Implicit Intents。 通 过 这 种 模式 ， 提 供 一 种 灵活 可 扩展 的 模式 ， 给 用 户 和 第 三 方 应 用 一 个 
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选择 权 。 例如 , 一 个 邮箱 软件 , 大 部 分 功能 都 不 错 , 但 是 选择 图 片 的 功能 不 尽 人 意 , 如 果 采 用 Implicit 
Intents， 那 么 它 就 是 一 个 开放 的 体系 ， 如 果 想 用 手机 中 的 其 他 图 片 代 蔡 邮 箱 中 默认 的 图 片 ， 可 以 完 
成 这 一 功能 。 但 该 模式 需要 付出 性 能 上 的 开销 ， 因 为 毕竟 存在 一 个 检索 过 程 。 于 是 Android 提供 了 
另 一 种 模式 Explicit Intents ， 该 模式 需要 Component 对 象 。Component 就 是 完整 的 类 名 ， 形 如 
comxxxxxxxxx ， 一 旦 指明 就 可 以 直接 调用 。 根 据 该 属性 是 否 被 指定 ，Intent 可 分 为 显 式 Intent 和 
隐 式 Intent。 

6. Extra 


Intent 的 Extra 属性 用 于 添加 一 些 组 件 的 附加 信息 。 比 如 ， 要 通过 一 个 Activity 执行 “发 送 电 
子 邮件 ”这 个 动作 请 求 ， 可 以 将 电子 邮件 的 subject、body 等 保存 在 Extras 里 ， 传 给 电子 邮件 发 送 
组 件 。 








5.1.1 Sst Intent 和 隐 式 Intent 


Intent 寻找 目标 组 件 的 方式 分 为 两 种 : 显 式 Intent 和 隐 式 Intent. 

显 式 Intent 是 通过 指定 Intent 组 件 名 称 来 实现 的 , 它 一 般 用 在 源 组 件 已 知 目标 组 件 名 称 的 前 提 
下 ， 这 种 方式 一 般 在 应 用 程序 内 部 实现 。 比 如 在 某 应 用 程序 内 ， 一 个 Activity 启动 一 个 Service。 

在 不 同 应 用 程序 之 间 ， 在 不 知道 目标 组 件 名 称 的 情况 下 ， 寻 找 目 标 组 件 需要 使 用 隐 式 Intent. 
这 种 方式 是 通过 IntentFilter 实现 的 。 


5.1.2 IntentFilter 


为 了 支持 隐 式 Intent， 可 以 声明 一 个 甚至 多 个 IntentFilter。 每 个 IntentFilter 描述 组 件 所 能 响应 
Intent 请 求 的 能 力 。 比 如 请 求 网 页 浏览 器 ， 网 页 浏览 器 程序 的 IntentFliter 就 应 该 声明 它 所 希望 接收 
的 IntentFilter Action 是 WEB SEARCH ACTION, 以 及 与 之 相关 的 请 求 数据 是 网 页 地 址 URI 格式 。 

如 何 为 组 件 声 明 自 己 的 IntentFilter? 常见 的 方法 是 在 Android Manifestxml 文件 中 用 属性 
<Intent-Filter> 描 述 组 件 的 IntentFilter。 

一 个 隐 式 Intent 请 求 要 能 够 传递 目标 组 件 ， 必 要 通过 Action, Data 以 及 Category 三 方面 的 检 
查 。 任 何 一 方面 不 匹配 ，Android 都 不 会 将 该 隐 式 Intent 传递 给 目标 组 件 。 接 下 来 我 们 讲解 这 三 方 
面 检查 的 具体 规则 。 


1. 动作 测试 
<intent-Filter> 元 素 中 可 以 包含 子 元 素 <action>， 比 如 : 


<intent-Filter> 

<action android:name- “com.example.project .SHOW-CURRENT” /> 
«action android:name- “com.example.project .SHOW-RECENT” /> 
«action android:name- “com.example.project .SHOW-PENDING” /> 
</intent-Filter> 


一 条 <intent-Filter> 元 素 至 少 包含 一 个 <action>， 否 则 任何 Intent 请 求 都 不 能 和 该 <intent-Filter> 
匹配 。 
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如 果 Intent 请 求 的 Action 和 <intent-Filter> 中 的 某 一 条 <action> 匹 配 ， 那 么 该 Intent 就 通过 了 这 
条 <intent-Filter> 的 动作 测试 。 
如 果 Intent 请 求 或 者 <intent-Filter> 中 没有 说 明 具 体 的 Action 类 型 ， 那 么 就 会 出 现下 面 这 两 种 
情况 。 
© 如 果 <intent-Filter> 中 没有 包含 任何 Action 类 型 ， 那 么 无 论 什 么 Intent 请 求 都 无 法 和 这 条 
<imtent-Filter> 匹 配 。 
@ 反之 , 如 果 Intent 请 求 中 没有 设 定 Action 类 型 , 那么 只 要 <intent-Filter> 中 包含 有 Action 类 型 ， 
这 个 Intent 请 求 就 将 顺利 通过 <intent-Filter> 的 行为 测试 。 


2. 类 别 测试 
<intent-Filter> 元 素 可 以 包含 <category> 子 元 素 ， 比 如 : 





<intent-Filter> 

<category android:name= “android.Intent.Category.DEFALT” /> 
<category android:name= “android. Intent.Category.BROWSABLE” /> 
</intent-Filter> 


AA Intent 请 求 中 所 有 的 Category 与 组 件 中 某 一 个 Intent 的 <catetory> 完 全 匹配 时 ， 才 会 让 
该 Intent 请 求 通过 测试 ，IntentFilter 中 多 余 的 <category> 声 明 并 不 会 导致 匹配 失败 。 一 个 没有 指定 
任何 类 别 Intent 请 求 与 指定 了 “android.Intent.Category.DEFALT” 类 别 的 IntentFliter 相 匹 配 。 


3. 数据 测试 
数据 在 <intent-Filter> 中 的 描述 如 下 : 


<intent-Filter> 

«data android:type- “video/mpeg” android:scheme= “http” .../» 
«data android:type= “audio/mpeg” android:scheme= “http” .../» 

</intent-Filter> 


<data> 元 素 指定 了 要 接受 的 Intent 请 求 的 数据 URI 及 数据 类 型 ， 其 中 URI 被 分 成 三 部 分 来 进 
行 匹 配 : scheme. authority 和 path。 用 setData0 设 定 的 Intent 请 求 的 URI 数据 类 型 和 scheme 必须 
与 IntentFilter 中 所 指定 的 一 致 。 若 IntentFilter 中 还 指定 了 authority 或 path， 它 们 也 需要 匹配 才 会 
通过 测试 。 


52 拨号 程序 


借助 于 Intent 可 以 轻松 实现 拨打 电话 的 应 用 程序 。 只 需 声 明 一 个 拨号 的 Intent 对 象 ， 并 使 用 
startActivity0) 方 法 启动 即 可 。 

创建 Intent 对 象 的 代码 为 Intent intent=new Intent (action,uri)， 其 中 URI 是 要 拨 叫 的 号 码 数 据 ， 
通过 Uriparse() 方 法 把 “tel:1234” 格 式 的 字符 串 转换 为 URI。 而 Action 有 两 种 使 用 方式 : 一 种 是 
IntenLAction CALL， 直 接 进 行 呼叫 的 方式 ， 这 种 方式 需要 应 用 程序 具有 android permission. 
CALL PHONE 权限 ; 另 一 种 是 Intent.Action DIAL， 这 种 不 是 不 直接 进行 呼叫 ， 而 是 启动 Android 
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系统 的 拨号 应 用 程序 ， 然 后 由 用 户 进行 拨号 。 这 种 方式 不 需要 任何 权限 的 设置 。 
实例 phoneDemo 演示 了 使 用 Intent Action CALL 方式 进行 拨号 的 过 程 ， 运 行 效果 如 图 5.1 所 示 。 





DIALING 





图 5.1 使 用 Intent. Action CALL 方式 拨号 


实例 phoneDemo 中 main.xml 的 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
<LinearLayout xmlns:android="http://schemas. android. com/apk/res/android" 
android: orientation="vertical" 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
> 
<EditText 
android: layout_marginTop="30dp" 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android: id="@tid/edittext" 
android: layout_marginLeft="40dp" 
/> 
<Button 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android: text=" #4 i4" 
="@+id/button" 
ayout_marginLeft="80dp" 
android:layout_marginTop="40dp" 
/> 
</LinearLayout> 






实例 phoneDemo  AndroidManifest.xml 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android="http://schemas. android. com/apk/res/android" 
package-"introduction.android.phone" 
android:versionCode-"1" 
android:versionName-"].0"» 
«uses-sdk android:minSdkVersion-"10" /> 
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«application android:icon="@drawable/icon" android:label-"éstring/app name"» 
«activity android:name-".PhoneDemoActivity" 
android:label-"G8string/app name"> 
Xintent-filter» 
«action android:name-"android.intent.action.MAIN" /> 
«category android:name="android. intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
<uses-permission android:name-"android.permission.CALL PHONE"»«/uses-permission» 
</manifest> 


实例 phoneDemo 中 PhoneDemoActivity.java 的 具体 实现 代码 如 下 : 


package introduction.android.phone; 
import android.app.Activity; 
import android.content. Intent; 
import android.net.Uri; 
import android.os.Bundle; 
import android.view.View; 
import android.view.View.OnClickListener; 
import android.widget.Button; 
import android.widget.EditText; 
public class PhoneDemoActivity extends Activity { 
/** Called when the activity is first created. */ 
private Button button; 
private EditText edittext; 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
button- (Button) findViewById (R.id.button) ; 
button.setOnClickListener (new buttonListener()) ; 
} 
class buttonListener implements OnClickListener{ 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
edittext= (EditText) findViewById (R.id.edittext) ; 
String number-edittext.getText ().toString(); 
Intent intent-new Intent (Intent.ACTION CALL,Uri.parse ("tel:"+number)) ; 
startActivity (intent) ; 
H 


} 
其 中 : 


Intent intent-new Intent (Intent.ACTION CALL,Uri.parse ("tel:"+number)) ; 
startActivity (intent) ; 


通过 Intent.ACTION_CALL 建立 了 一 个 进行 拨号 的 Intent 请 求 , 并 使 用 startActivity 直接 启动 Android 
系统 的 拨号 程序 进行 呼叫 。 
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若 在 实例 PhoneDemo 中 ， 将 PhoneDemoActivity java 中 的 代码 : 


Intent intent-new Intent (Intent.ACTION CALL,Uri.parse 
("tel:"+number)) ; 


修改 为 : 


Intent intent=new Intent (Intent.ACTION DIAL,Uri.parse 
("tel:"+number)) ; 


最 后 , 单 击 “ 拨 打 电 话 ” 按 钮 后 不 再 直接 呼叫 ,而 是 只 运行 Android 
系统 默认 的 拨号 程序 ， 用 户 还 拥有 进一步 决定 下 一 步 操作 的 权限 ， 运 
行 效果 如 图 5.2 所 示 。 








5.3 短信 程序 


图 5.2 拨打 电话 


5.3.1 SMS 简介 


SMS (Short Message Service， 短 信息 服务 ) 是 一 种 存储 和 转发 服务 。 也 就 是 说 ， 短 信息 并 不 
是 直接 从 发 信人 发 送 到 接收 入 , 而 是 始终 通过 SMS 中 心 进行 转发 。 如 果 接收 人 处 于 未 连接 状态 (可 
能 电话 已 关闭 ) ， 那 么 信息 将 在 接收 人 再 次 连接 时 发 送 。 


5.3.2 ”接收 短信 


要 使 Android 应 用 程序 能 够 接收 短信 息 ， 需 要 以 下 三 个 步 又: 

€D) Android 应 用 程序 必须 具有 接收 SMS 短信 息 的 权限 ， 在 AndroidManifestxml 文件 中 
配置 如 下 : 

<uses-permission android:name="android.permission.RECEIVE_SMS'/> 

Eo Android 应 用 程序 需要 定义 一 个 BroadcastReceiver 的 子 类 ， 并 通过 重 载 其 public void 
onReceive (Context arg0, Intent argl) 方法 来 处 理 接收 到 短信 息 的 事件 。 

€X303 在 AndroidManifest.xml 文件 中 对 BroadcastReceiver 子 类 的 <intent-filter> 属 性 进行 配 
置 ， 使 其 能 够 获取 短信 息 接收 Action MEWT: 

<intent-filter> 


<action android:name-"android.provider.Telephony.SMS RECEIVED"/> 
</intent-filter> 


5.3.3 ”接收 短信 实例 


实例 receiveMessageDemo 演示 了 接收 短信 并 提示 的 过 程 ， 运 行 效果 如 图 5.3 所 示 。 
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| ReceiveMessageDemo 


waiting... 


发 信人 : 
15555215556 信 息 内 容 : 
Receive Message Demo 





图 5.3 receiveMessageDemo 实例 


其 layout 文件 main.xml 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
android: orientation="vertical"> 
<EditText 
android: id="@t+id/editText1" 
android: layout_width="match parent" 
android: layout_height="wrap content"> 
<requestFocus /> 
</EditText> 
</LinearLayout> 


AndroidManifest.xml 文件 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android="http://schemas. android. com/apk/res/android" 
package-"introduction.android.receiveMessage" 
android:versionCode-"]" 
android:versionName-"].0"» 
<uses-sdk android:minSdkVersion-"14" /> 
<uses-permission android:name-"android.permission.RECEIVE SMS"/> 
<application 
android: icon="@drawable/ic launcher" 
android: label="@string/app_name"> 
<activity android:name=".ReceiveMessageDemoActivity" 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name-"android.intent.action.MAIN" /> 
«category android:name="android. intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 
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Java 


<receiver android:name="SmsReceiver"> 
<intent-filter> 
«action android:name="android. provider. Telephony.SMS RECEIVED"/> 
</intent-filter> 
</receiver> 
</application> 
</manifest> 


ReceiveMessageDemoActivity java 的 代码 如 下 : 


package introduction.android.receiveMessage; 


import android.app.Activity; 
import android.os.Bundle; 
import android.widget.EditText; 


public class ReceiveMessageDemoActivity extends Activity ( 

/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
EditText text= (EditText) this.findViewById (R.id.editText1) ; 
text.setText ("waiting...") ; 


) 


Intent 广播 接收 器 定义 为 SmsReceiver， 用 于 对 接收 到 短 
的 代码 如 下 : 


package introduction.android.receiveMessage; 





import android.content.BroadcastReceiver; 
import android.content.Context; 
import android.content.Intent; 
import android.os.Bundle; 
import android.telephony.SmsMessage; 
import android.widget.Toast; 
public class SmsReceiver extends BroadcastReceiver { 
StringBuilder strb=new StringBuilder (); 
@Override 
public void onReceive (Context arg0, Intent argl) { 
// TODO Auto-generated method stub 
Bundle bundle-argl.getExtras(); 
Object[] pdus- (Object[]) bundle.get ("pdus") ; 
SmsMessage[] msgs-new SmsMessage[pdus.length]; 
for (int i-0; i«pdus.length; i++) ( 
msgs [i]-SmsMessage.createFromPdu ((byte[]) pdus[i]) ; 
5 
for (SmsMessage msg : msgs) { 
strb.append (" 发 信人 : Nn") ; 
strb.append (msg.getDisplayOriginatingAddress()) ; 
strb.append ("Wn 信息 内 容 : \n") ; 
strb.append (msg.getDisplayMessageBody()) ; 
p 
Toast.makeText (arg0, strb.toString(), Toast.LENGTH LONG) .show(); 


息 的 事件 进行 处 理 。SmsReceiver. 
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} 
} 


当 接收 到 短信 息 后 ，onReceive 方法 被 调用 。 由 于 Android 设备 接收 到 的 SMS 短信 息 是 PDU 
(Protocol Description Unit) 形式 的 ， 因 此 通过 Bundle 类 对 象 获取 到 PDUS， 并 创建 SmsMessage 
对 象 。 然 后 从 SmsMessage 对 象 中 提取 出 短信 息 的 相关 信息 ， 并 存储 到 StringBuilder 类 的 对 象 中 ， 
最 后 使 用 Toast 显示 出 来 。 
测试 该 实例 时 , 可 通过 AVD Mananger, 再 启动 一 个 AVD, 通过 AVD 的 短信 程序 向 当前 AVD 
号 码 发 送 短 信 ， 就 可 使 该 实例 被 触发 运行 。 














534 ”发 送 短信 


要 实现 发 送 短信 功能 ， 需 要 在 AndroidManifestxml 文件 中 注册 发 送 短信 的 权限 : 
<uses-permission android:name="android.permission.SEND_SMS'"/>， 然 后 才 可 以 使 用 发 送 短信 功能 。 
发 送 短信 使 用 的 是 android .telephony.SmsManager 类 的 sendTextMessage 方法 ， 该 方法 定义 如 下 : 
public void sendTextMessage ( String destinationAddress, String scAddress, String text, 
PendingIntent sentIntent, PendingIntent deliveryIntent) 
其 中 ， 各 个 参数 的 意义 如 下 。 
destinationAddress: 表示 接收 短信 的 手机 号 码 。 
scAddress: 短信 服务 中 心 号 码 ， 设 置 为 null 表示 使 用 手机 默认 的 短信 服务 中 心 。 
text: 要 发 送 的 短信 内 容 。 
sentIntent: 当 消 息 被 成 功 发 送 给 接收 者 时 ， 广 播 该 PendingIntent。 
deliveryIntent: 当 消 息 被 成 功 发 送 时 ， 广 播 该 PendingIntent。 


5.3.5 ”短信 发 送 实例 


实例 sendMessageDemo 演示 了 发 送 短信 的 过 程 ， 其 运行 效果 如 图 5.4 所 示 。 


短信 和 内容 wo de di yi ge 


图 5.4 sendMessageDemo 实例 








在 实例 sendMessageDemo 中 ，main.xml 的 代码 如 下 : 
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<?xml version="1.0" encoding-"utf-8"?» 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 
<LinearLayout 
android: orientation="horizontal" 
android: layout_width="fill parent" 
android: layout_height="wrap_content" 
> 
<TextView 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android: id="@t+tid/textview01" 
android: text=" fA: " 
android:layout_marginLeft="15dp" 
/> 
<EditText 
android: layout_marginLeft="20dp" 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
android: id="@t+tid/edittext01" 
/> 


</LinearLayout> 
<LinearLayout 
android:orientation="horizontal" 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android: layout_marginTop="30dp" 
> 
<TextView 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android: id="@+tid/textview02" 
android: text="@string/receiver" 
android: layout_marginLeft="15dp" 
/> 
<EditText 
android: layout_marginLeft="10dp" 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android: id="@t+id/edittext02" 
/> 
</LinearLayout> 
<Button 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android: id="@tid/button" 
android: layout_marginLeft="100dp" 
android: layout_marginTop="30dp" 
android: text="@string/msg” 
/> 
</LinearLayout> 
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在 实例 sendMessageDemo 中 ，AndroidManifestxml 的 代码 如 下 : 


<?xml version-"1.0" encoding="utf-8"2> 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"introduction.android.SendMessage" 
android:versionCode-"]" 





android:versionName-"].0"» 
«uses-sdk android:minSdkVersion-"10" /> 


<application android:icon="@drawable/icon" android:label-"68string/app name"> 
«activity android:name=".SendMessageDemoActivity" 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name-"android.intent.action.MAIN" /> 
<category android:name="android. intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
<uses-permission android:name-"android.permission.SEND SMS"/> 
</manifest> 


在 实例 sendMessageDemo H, SendMessageDemoActivity.java 实现 了 发 送 短信 的 功能 ， 其 代码 
如 下 : 


package introduction.android.SendMessage; 
import android.app.Activity; 

import android.os.Bundle; 

import android.telephony.SmsManager; 
import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 

import android.widget .EditText; 

import android.widget.Toast; 


public class SendMessageDemoActivity extends Activity { 
/** Called when the activity is first created. */ 
private Button button; 
private EditText edittext01,edittext02; 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
button- (Button) findViewById (R.id.button) ; 
button.setOnClickListener (new buttonListener() ) ;// 为 发 送 按钮 添加 监听 器 
} 
class buttonListener implements OnClickListener{ 


@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
edittext01- (EditText) findViewById (R.id.edittext01) ; 
edittext02- (EditText) findViewById (R.id.edittext02) ; 
String number=edittext01.getText () .toString(); 
// 获 取 手 机 号 码 


String message0l-edittext02.getText().toString():; 
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// 获 取 短信 内 容 
if (number.equals ("") || message01.equals ("")) 
// 判 断 输入 是 否 有 空 内 容 
{ 
Toast.makeText (SendMessageDemoactivity.this，" 输 入 有 误 ， 请 检查 输入 "， 
Toast.LENGTH LONG) .show(); 
i 
else{ 
SmsManager massage-SmsManager.getDefault(); 
massage.sendTextMessage (number, null, message01, null, null) ; 
// 调 用 sendTextMessage 方法 来 发 送 短信 
Toast.makeText (SendMessageDemoActivity.this, "短信 发 送 成 功 "， 
Toast.LENGTH LONG) .show(); 
} 
} 


} 

在 实际 应 用 该 短信 发 送 程序 时 ， 要 注意 一 些 限制 问题 ， 比 如 接收 手机 号 码 的 格式 、 短 信 内 容 
超过 预定 字符 的 提示 等 。 一 般 情 况 下 ， 手 机 号 码 格式 可 以 使 用 Pattern 来 设置 ， 此 外 Android SDK 
提供 了 PhoneNumberUtils 类 来 对 电话 号 码 格式 进行 处 理 ， 而 短信 内 容 超过 70 个 字符 会 被 自动 分 解 
为 多 条 短信 发 送 ， 在 此 不 做 具体 描述 。 


5.4 照相 机 程序 


借助 于 Intent， 可 以 方便 地 调用 Android 系统 的 照相 机 程序 进行 拍照 。 但 是 需要 声明 摄像 头 的 
使 用 权限 ， 即 在 AndroidManifest.xml 文件 中 添加 如 下 代码 : 


<uses-permission android:name="android.permission.CAMERA"/> 
<uses-feature android:name-"android.hardware.camera"/» 


实例 CameraDemo 演示 了 通过 Intent 调用 系统 的 拍照 程序 并 返回 照片 的 过 程 , 该 实例 运行 效果 
如 图 5.5 所 示 。 


| | CameraDemo 


E camerapemo 
启动 摄像 头 
启动 摄像 头 





图 5.5 CameraDemo 实例 运行 效果 


当 单 击 “ 启 动 摄像 头 ”按钮 时 ， 启 动 Android 系统 自 带 的 照相 机 应 用 程序 进行 拍照 ， 并 将 拍摄 
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的 照片 显示 到 ImageView 组 件 中 。 
实例 CameraDemo 中 的 main.xml 代码 如 下 : 


<?xml version-"1.0" encoding="utf-8"2> 
<LinearLayout xmlns:android="http://schemas. android. com/apk/res/android" 
android: orientation="vertical” 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
> 


<Button 
android: id="@+id/button1" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:text="@string/camera" /> 


<ImageView 
android: layout_width="wrap content" 
android: layout_height="wrap_ content" 
android: id="@+id/imageview" 
/> 
</LinearLayout> 


在 实例 CameraDemo 中 的 AndroidManifest.xml 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
<manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package="introduction.android.camera" 
android: versionCode="1" 
android: versionName="1.0"> 
<uses-sdk android:minSdkVersion="14" /> 


<application android: icon="@drawable/icon" android: label="@string/app_name"> 
«activity android:name-".CameraDemoActivity" 
android:label-"68string/app name"» 
<intent-filter> 
<action android:name-"android.intent.action.MAIN" /> 
<category android:name="android. intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
<uses-permission android:name="android. permission. CAMERA"/> 
<uses-feature android:name="android. hardware. camera"/> 
</manifest> 


在 实例 CameraDemo 中 的 CameraDemoActivity.java 代码 如 下 : 


package introduction.android.camera; 


import android.app.Activity; 
import android.content. Intent; 
import android.graphics.Bitmap; 
import android.os.Bundle; 

import android.provider.MediaStore; 
import android.util.Log; 


import android.view.View; 
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import android.view.View.OnClickListener; 
import android.widget.Button; 
import android.widget.ImageView; 


public class CameraDemoActivity extends Activity ( 
/** Called when the activity is first created. */ 
private ImageView imageview; 
private Button btn; 
GOverride 
public void onCreate (Bundle savedInstanceState) ( 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
imageview- (ImageView) findViewById (R.id.imageview) ; 
btn- (Button) findViewById (R.id.buttonl) ; 
btn.setOnClickListener (new OnClickListener() { 
public void onClick (View v) ( 
// TODO Auto-generated method stub 
try{ 
Intent i=new Intent (MediaStore.ACTION IMAGE CAPTURE) ; 
startActivityForResult (i, 1) ; 
} 
catch (Exception e) ( 
Log.d ("cameraDemo", e.toString()) ; 


protected void onActivityResult (int requestcode, int resultCode,Intent data) { 
try{ 
if (requestcode !=1) { 
return; 
} 
super.onActivityResult (requestcode, resultCode, data) ; 
Bundle extras-data.getExtras(); 
Bitmap bitmap- (Bitmap) extras.get ("data") ; 
imageview.setImageBitmap (bitmap) ; 
} 
catch (Exception e) { 
Log.d ("cameraDemo", e.toString()) ; 


) 


在 启动 摄像 头 程序 时 ， 因 为 要 传 回 拍摄 的 图 像 ， 所 以 调用 了 Activity. startActivityForResult (Intent 
intent, int requestCode) 方法 。 当 startActivityForResult0 方 法 启动 的 Activity 正常 结束 时 ， 会 自动 返 
回 发 出 请 求 的 Activity, 并 且 该 方法 会 返回 对 应 的 requestCode 值 给 onActivityResult(int requestcode, 
int resultCode,Intent data) 方法 , 借 此 可 以 在 请 求 Activity 和 发 出 请 求 的 Activity 之 间 进 行 数据 传递 。 
本 实例 借助 于 这 一 特点 传 回 了 Android 系统 照相 机 程序 拍摄 的 照片 。 
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5.5 小 结 


Intent 是 组 成 Android 应 用 程序 的 主要 组 成 部 分 之 一 。 在 Intent 对 象 中 指定 程序 将 要 执行 的 动 
TE CAction) , 以 及 程序 执行 该 动作 时 所 需要 的 数据 (Data) , 并 使 用 startActivity0 方 法 启动 该 mtent 
对 象 。 

本 章 简单 介绍 了 显 式 Intent 和 隐 式 Intent 的 使 用 方法 ， 并 举例 说 明了 使 用 Intent 调用 手机 短信 
和 拨号 程序 的 方法 ， 以 及 通过 startActivityForResult( 方 法 调用 系统 摄像 头 应 用 程序 的 方法 。 使 用 
Intent 调用 手机 相关 功能 时 ， 要 注意 要 在 AndroidManifestxml 文件 中 注册 相应 的 权限 ，Android 系 
统 会 通过 intent-filter 属性 自动 寻找 符合 要 求 的 应 用 程序 并 执行 。 

借助 于 Intent， 程 序 员 可 以 方便 地 调用 Android 系统 中 的 其 他 应 用 程序 ， 例 如 启动 网 络 浏览 器 
进行 网 上 冲浪 、 收 发 E-Mail 等 。 读 者 可 举一反三 ， 通 过 Intent 使 自己 开发 的 应 用 程序 更 加 方便 和 
强大 。 


1. Intent 可 调用 各 种 系统 功能 ， 如 访问 网 络 、 显 示 地 图 、 收 发 E-mail 等 ， 请 尝试 实现 。 
2. Intent 与 Intent Filter 的 匹配 规则 是 什么 ? 


多 媒体 开发 


6.1 Service 


在 Android 系统 中 ，Service 不 是 一 个 单独 的 进程 ， 除 非特 殊 设 定 ， 否 则 它 不 会 单独 运行 在 自 
己 的 进程 中 ， 通 常情 况 下 它 是 作为 启动 应 用 程序 的 一 部 分 与 当前 应 用 程序 运行 在 同一 个 进程 中 。 


6.1.1 Service 的 作用 


服务 程序 Service 是 一 种 可 以 在 后 台 长 时 间 运 行 并 且 不 提供 用 户 UI 的 程序 。 即 使 启动 Service 
的 应 用 程序 被 切换 掉 ， 其 启动 的 Service 也 可 以 在 后 台 正常 运行 。 因 此 ，Service 经 常 被 用 来 处 理 一 
些 耗 时 比较 长 的 程序 ， 例 如 进行 网 络 传输 或 播放 音乐 等 。 


6.1.2 Service 的 生命 周期 


Android 开发 中 ， 当 需要 创建 在 后 台 运行 的 程序 的 时 候 ， 就 要 用 到 Service. Service 可 以 分 为 
有 无 限 生 命 和 有 限 生 命 两 种 。 需 要 特别 注意 的 是 ，Service PR Activity 是 不 同 的。 简单 来 说 ， 可 以 
理解 为 后 台 与 前 台 的 区 别 ，Activity 拥有 UI， 可 以 与 用 户 交 互 ， 而 Service 则 不 能 。 当 系统 资源 不 
足 时 ，Activity 可 能 会 被 系统 销毁 以 释放 资源 ， 而 Service 不 会 。 

Service 类 中 定义 了 一 系列 和 自身 生命 周期 相关 的 方法 ， 在 此 不 一 一 介绍 ， 最 经 常 使 用 的 有 以 
事 三 直方 法 : 

* onCreate() 24 Service 第 一 次 被 创建 时 ， 系 统 调 用 该 方法 。 

* onStartCommand ( Intent intent,int flags,int startld) ” 当 通 过 startService() 方 法 启动 Service I}, 

该 方法 被 调用 。 
* onDestoy() 2i Service 不 再 使 用 时 ， 系 统 调 用 该 方法 。 
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6.1.3 ah Service 


要 启动 服务 程序 Service， 要 先 在 应 用 程序 的 AndroidManifest- XML 配置 文件 内 声明 <service> 
标签 。 例 如 ， 如 果 建 立 了 一 个 ExampleService 的 Servicee， 就 要 在 配置 文件 中 添加 如 下 代码 : 


<service android:name= “.ExampleService” /> 


此 外 ，<service> 标 签 可 用 含有 <intent-filter> 的 标签 对 该 Service 进行 必要 的 说 明 。 

启动 Service 有 两 种 方式 : Context.startService()fll Context.bindService(). 

© public abstract void startService (Intent service), HEP, AK service 是 要 启动 的 服务 程序 的 名 称 。 

* public abstract boolean bindService ( Intent service,ServiceConnection conn,int flags )。 其 中 ， 参 
数 service 是 定义 要 绑 定 的 服务 程序 的 名 称 ; conn 是 当 服 务 程 序 启动 和 停止 时 ,负责 接收 信息 
的 接口 程序 ; flags 是 设置 绑 定 作业 的 选项 ， 可 以 是 0、BIND AUTO CREATE. 
BIND DEBUG UNBIND、BIND NOT FOREGROUND, BIND ABOVE_CLIENT、BIND_ 
ALLOW_OOM MANAGEMENT 或 者 BIND WAIVE PRIORITY. 


通过 startService() 来 启动 Service， 该 方法 会 调用 Service 中 的 onCreate()fll onStartCommand() 
方法 来 启动 一 个 后 台 Service， 当 Service 销毁 时 直接 调用 onDestroy() 方 法 。 

若 通过 bindService0 方 法 启动 Service， 则 其 生命 周期 受 其 绑 定 对 象 控制 。 一 个 Service 可 以 同 
时 绑 定 到 多 个 对 象 上 ， 当 没有 任何 对 象 绑 定 到 Service 上 时 ， 该 Service 会 被 系统 销毁 。 

两 种 方式 对 Service 生命 周期 的 影响 如 图 6.1 所 示 。 


‘Component calls Component calls 
startService() bindService() 


onCreate() onCreate() 
Service is running " 





Service is running 
(clients are 
bound 


toit) 






All clients unbind by calling ] 
unbindService() 





Unbounded Bounded 


图 6.1 两 种 方式 的 比较 
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由 图 6.1 不 难看 出 , 通过 bindService() 方 法 启动 时 和 startService() 方 法 一 样 ,都 会 调用 onCreate() 
方法 来 创建 Service， 但 它 不 会 调用 onStartCommand( 方 法 ， 而 是 调用 onBind0 方 法 返回 客户 端 一 
个 IBinder 接口 。 这 个 IBinder 就 是 在 Service 的 生命 周期 回调 方法 onBind0 中 的 返回 值 。 服 务 运行 
后 ， 与 前 者 不 同 的 是 ， 不 是 服务 终止 ， 而 是 使 用 ContextunbindService() 方 法 之 后 ，Service 的 生命 
周期 回调 onUnbindO 会 被 调用 。 如 果 所 有 bind 过 Service 的 组 件 都 调用 unbindService() 方 法 ， 那 么 
之 后 Service 会 被 停止 ， 其 onDestroy0 回 调 会 被 调用 。 








6.2 BroadcastReceiver 





广播 (Broadcast) 是 Android 系统 中 应 用 程序 间 通 信 的 手段 。 当 有 特定 事件 发 生 时 ， 例 如 有 来 
电 、 有 短信 、 电 池 电 量变 化 等 事件 发 生 时 ，Android 系统 都 会 产生 特定 的 Intent 对 象 并 且 自 动 进行 
广播 , 而 针对 特定 事件 注册 的 BroadcastReceiver 会 接收 到 这 些 广 播 ， 并 获取 Intent 对 象 中 的 数据 进 
行 处 理 。 在 广播 ntent 对 象 时 可 以 指定 用 户 权限 , 以 此 限制 仅 有 获得 了 相应 权限 的 BroadcastReceiver 
才能 接收 并 处 理 对 应 的 广播 。 

BroadcastReceiver 有 动态 和 静态 两 种 注册 方法 ,动态 注册 方法 即使 用 Context. registerReceiver() 
方法 进行 注册 ,需要 特别 注意 的 是 , 动态 注册 方法 在 退出 程序 前 要 使 用 Context.unregisterReceiver() 
方法 撤销 注册 。 静 态 注册 方法 即 在 AndroidManifestxml. 文 件 中 通过 <receiver> 标 签 进行 注册 。 

一 个 BroadcastReceiver 对 象 只 有 在 被 调用 onReceive (Context, Intent) 时 才 有 效 ， 当 从 该 函数 
返回 后 ， 该 对 象 就 已 无 效 了 ， 其 生命 周期 结束 。 

下 面 介绍 如 何 使 用 动态 注册 来 实现 监听 电池 剩余 电量 。 

实例 BatteryDemo 演示 了 使 用 动态 注册 BroadcastReceiver 对 象 并 且 接 收 系统 电量 改变 事件 并 

加 以 处 理 的 过 程 ， 运 行 效果 如 图 6.2 所 示 。 





| BatteryDemo 


检测 当前 手机 电量 





图 6.2 BatteryDemo 的 运行 效果 


实例 BatteryDemo 中 main.xml 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
android:orientation="vertical"> 


«ToggleButton 
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android: id="@+id/button" 
android:textOn=" 检 测 当前 手机 电量 " 
android:textOff=" 停 止 检测 " 

android: layout_width="fill parent" 
android: layout_height="wrap content" 
ox 


<TextView 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
android: id="@+id/text"/> 


</LinearLayout> 


实例 BatteryDemo 中 AndroidManifest.xml 的 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"introduction.android.batteryDemo" 
android:versionCode-"1" 
android:versionName-"1.0"» 

<uses-sdk android:minSdkVersion-"14" /> 
<application 
android: icon="@drawable/ic_ launcher" 
android: label="@string/app_name"> 
<activity 
android:name-"introduction.android.batteryDemo.BatteryDemoActivity" 
android: label="@string/app_name"> 
<intent-filter> 








<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
</manifest> 


实例 BatteryDemo 中 BatteryDemoActivity java 的 具体 实现 代码 如 下 : 


package introduction.android.batteryDemo; 





import introduction.android.batteryDemo.R; 
import android.app.Activity; 

import android.content.BroadcastReceiver; 
import android.content.Context; 

import android.content.Intent; 

import android.content.IntentFilter; 
import android.os.Bundle; 

import android.widget.CompoundButton; 
import android.widget.CompoundButton.OnCheckedChangeListener; 
import android.widget.TextView; 

import android.widget.ToggleButton; 


public class BatteryDemoActivity extends Activity ( 
/** Called when the activity is first created. */ 
private ToggleButton button; 


private TextView text; 
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BroadcastReceiver receiver=null; 


@override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
button- (ToggleButton) findViewById (R.id.button) ; 
text- (TextView) findViewById (R.id.text) ; 


final BroadcastReceiver receiver-new BroadcastReceiver () { 


@Override 
public void onReceive (Context context, Intent intent) { 
// TODO Auto-generated method stub 
String action=intent.getAction(); 
if (Intent.ACTION BATTERY CHANGED.equals (action)) { 
int current-intent.getExtras().getInt ("level") ;// 获取 当前 电量 
int total-intent.getExtras().getInt ("scale") ;// 获取 总 电量 
int value-current * 100 / total; 
text.setText ("当前 电量 是 "tvaluet"%"+"") ; 


he 
button.setOnCheckedChangeListener (new OnCheckedChangeListener () { 


public void onCheckedChanged (CompoundButton buttonView, 
boolean isChecked) { 
// TODO Auto-generated method stub 
if (isChecked) { 
IntentFilter filter=new IntentFilter ( 
Intent.ACTION BATTERY CHANGED) ; 
registerReceiver (receiver, filter) ; 


) else ( 
unregisterReceiver (receiver) ; 


text.setText ("") ; 


jos 


HH, Intent. ACTION BATTERY CHANGED 为 当 电 池 电 量变 化 时 产生 的 Intent 对 象 中 携带 
的 Action 信息 。 


IntentFilter filter-new IntentFilter (Intent.ACTION BATTERY CHANGED) ; 


用 于 确定 当前 BroadcastReceiver 对 象 接收 的 Intent 对 象 的 类 型 。 
registerReceiver (receiver, filter) 动态 注册 receiver. 
int current=intent.getExtras().getInt ("level") 获取 当前 电池 的 电量 。 
int total=intent.getExtras().getInt ("scale") 获取 总 电量 。 











unregisterReceiver (receiver) 注销 receiver 注册 。 


该 应 用 程序 若 要 使 用 静态 注册 ， 则 需要 在 AndroidManifestxml 文件 中 添加 如 下 代码 : 
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«receiver android:name-"receiver"» 
<intent-filter> 
<action android:name="android. intent .action.BATTERY_CHANGED"/> 
</intent-filter> 
</receiver> 


63 Ë 5n 


Android 系统 支持 三 种 不 同 来 源 的 音频 播放 : 
CD 本 地 资源 

存储 在 应 用 程序 中 的 资源 , 例如 存储 在 RAW 文件 夹 下 的 媒体 文件 , 只 能 被 当前 应 用 程序 访问 。 
(2) 外 部 资源 

存储 在 文件 系统 中 的 标准 媒体 文件 ， 例 如 存储 在 SD 卡 中 的 文件 ， 可 以 被 所 有 应 用 程序 访问 。 
(3) 网 络 资 源 

通过 网 络 地 址 取得 的 数据 流 CURL) ， 例 如 “http://www.musiconline.comy/classic/007. mp3”， 

可 以 被 所 有 应 用 程序 访问 。 





6.3.1 Android N 支持 的 音频 格式 


Android N 支持 的 音频 格式 如 表 6.1 所 示 。 
表 6.1 Android N 支持 的 音频 格式 




















格式 / 编码 支持 的 文件 类 型 
AAC LC/LTP 3GPP (.3gp) 
HE-AACvI (AAC+) MPEG-4 (.mp4, .m4a) 
ADTS raw AAC 
HE-AACv2 (enhanced AAC+) d 
MPEG-TS (ts,not seekable,Android3.0+) 
AMR-NB 3GPP (.3gp) 
AMR-WB 3GPP (.3gp) 
FLAC FLAC (.flac) only 
MP3 MP3 (.mp3) 
Type 0 and 1 (.mid, xmf .mxmf) 
RITIL/RIX (rtttL rtx) 
MIDI 
OTA (.ota) 
iMelody (.imy) 
Ogg (: ) 
Vorbis ce 
Matroska 








PCM/WAVE WAVE (.wav) 
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6.32 ”音频 播放 器 
实例 MediaPlayerAudioDemo 演示 了 分 别 播放 三 种 类 型 的 资源 的 方法 。 该 实例 中 
MediaPlayerAudioActivity 向 Intent 对 象 中 传 入 要 载 入 的 资源 类 型 , 并 通过 该 Intent 启动 用 于 播放 音 








乐 的 Activity: PlayAudio。PlayAudio 根据 传 入 的 参数 分 别 获取 对 应 的 音乐 资源 并 且 播 放 。 实 例 


MediaPlayerAudioDemo 的 运行 效果 如 图 6.3 所 示 。 


播放 本 地 资源 的 音乐 正在 播放 本 地 资源 中 的 音乐 





图 63 MediaPlayerAudioDemo 的 运行 效果 


实例 MediaPlayerAudioDemo 中 的 main.xml 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 


<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 


android: orientation="vertical" 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
> 

<Button 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android: text=" JEJE f RTT RAN EK" 
android: id="@+id/button01" 


/> 
<Button 

android: layout_width="fill parent" 

android: layout_height="wrap content" 
= "ILENE" 
android: id="@+id/button02" 


android: te: 





/> 

<Button 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android: text=" HAMR WRIA" 
android:id="@+id/button03" 


/> 
</LinearLayout> 


168 | Android 7 应 用 程序 开发 教程 





实例 MediaPlayerAudioDemo 中 MediaPlayerAudioActivity java 文件 的 代码 如 下 : 


package introduction.android.mediaplayer; 


import android.app.Activity; 

import android.content.Intent; 

import android.os.Bundle; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 


public class MediaPlayerAudioActivity extends Activity implements OnClickListener ( 
/** Called when the activity is first created. */ 
private Button button01,button02,button03; 
private String PLAY-"paly"; 
private int Local-1; 
private int Stream-2 ; 
private int Resources-3 ; 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
button01- (Button) findViewById (R.id.button01) ; 
button02- (Button) findViewById (R.id.button02) ; 
button03- (Button) findViewById (R.id.button03) ; 
button01.setOnClickListener (this) ; 
button02.setOnClickListener (this) ; 
button03.setOnClickListener (this) ; 
) 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
Intent intent=new Intent (MediaPlayerAudioActivity.this, PlayAudio.class) ; 
if (v--button01) { 
intent.putExtra (PLAY, Local) ; 
} 
if (v==button02) { 
intent .putExtra (PLAY, Stream) ; 
} 
if (v==button03) { 
intent.putExtra (PLAY, Resources) ; 
} 
MediaPlayerAudioActivity .this.startActivity (intent) ; 


) 


实例 MediaPlayerAudioDemo  PlayAudio 类 实现 播放 音频 的 功能 ， 根 据 
MediaPlayer-AudioActivity 类 通过 Intent 传递 过 来 的 不 同 的 值 , 而 实现 三 种 不 同 的 播放 音频 的 方式 。 
PlayAudio.java 文件 的 代码 如 下 : 


package introduction.android.mediaplayer; 


import android.app.Activity; 
import android.media.MediaPlayer; 
import android.os.Bundle; 
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@Override 
protected void onDestroy() { 
// TODO Auto-generated method stub 
super.onDestroy (); 
if (mediaplayer !-null) 
£ 
mediaplayer. release (); 
mediaplayer=null ; 


} 


其 中 ，path 指向 要 播放 的 音频 文件 的 位 置 。 本 实例 中 ， 外 部 文件 系统 中 的 资源 是 放置 在 SD E 
中 的 music 目录 下 的 white.mp3; 网 络 资源 使 用 的 是 httpz//www.musiconline.com/ classic/007.mp3; 
本 地 资源 使 用 的 是 raw 目录 下 的 black.mp3 文件 。 

实例 MediaPlayerAudioDemo 中 AndroidManifest.xml 文件 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package-"introduction.android.mediaplayer" 
android:versionCode-"1" 
android:versionName-"1.0"» 
<uses-sdk android:minSdkVersion-"10" /> 


<application android:icon="@drawable/icon" android: label="@string/app_name"> 
<activity android:name-".MediaPlayerAudioActivity" 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name-"android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
<activity android:name=".playAudio"></activity> 
</application> 
</manifest> 


在 该 实例 中 ， 每 次 播放 音频 文件 时 都 会 从 MediaPlayerAudioActivity 跳 转 到 一 个 新 的 Activity, 
即 PlayAudio。 当 返回 MediaPlayerAudioActivity 时 ， 由 于 PlayAudio 对 象 被 释放 掉 ， 因 此 播放 的 音 
乐 也 随 之 停止 , 不 再 播放 。 若 想 在 返回 MediaPlayerAudioActivity 时 音乐 不 停止 , 则 需要 使 用 Service 
在 后 台 播放 音频 文件 。 





6.3.3 ”后 台 播放 音频 


实例 AudioServiceDemo 演示 了 如 何在 后 台 播 放 音 频 。 该 实例 的 运行 效果 如 图 6.4 所 示 。 当 用 
户 单 击 “启动 Service” 按 钮 时 ， 当 前 Activity 结束 ， 应 用 程序 界面 消失 ， 返 回 Android 应 用 程序 列 
表 ， 同 时 后 台 启 动 Service， 播 放 视频 文件 。 
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L| 


P AudioServiceDemo 


启动 Service 





图 6.4  AudioServiceDemo 的 运行 效果 


该 实例 界面 简单 ， 仅 一 个 按钮 。 布 局 文件 main.xml 的 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 
«Button 
android: id="@+id/button1" 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
启动 service " /> 





android: tex' 
</LinearLayout> 





实例 AudioServiceDemo Activity 文件 AudioServiceDemoActivity java 的 代码 如 下 : 


package introduction.android.AudioServiceDemo; 


import android.app.Activity; 
import android.content.Intent; 
import android.os.Bundle; 
import android.view.View; 
import android.widget.Button; 


public class AudioServiceDemoActivity extends Activity { 
/** Called when the activity is first created. */ 
private Button btn; 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
btn- (Button) findViewById (R.id.buttonl) ; 
btn.setOnClickListener (new View.OnClickListener ()( 


@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
startService (new Intent 
(“introduction.android.AudioServiceDemo.MY AUDIO SERVICE")) ; 
finish(); 
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AudioServiceDemoActivity 在 按钮 被 单 击 后 使 用 startService0 方 法 启动 了 自 定义 的 服务 
MY AUDIO SERVICE， 然后 调用 finish0 方 法 关闭 当前 Activity。 该 服务 需要 在 AndroidManifest. xml X 
件 中 进行 声明 。AndroidManifestxml 的 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 





package-"introduction.android.AudioServiceDemo" 
android:versionCode-"1" 
android:versionName-"1.0"» 


«uses-sdk android:minSdkVersion="14" /> 
<application android:icon="@drawable/ic_ launcher" android:label="@string/app name"> 


<activity android:name-".AudioServiceDemoActivity" 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name-"android.intent.action.MAIN"/» 
<category android:name="android. intent .category.LAUNCHER"/> 
</intent-filter> 
</activity> 
<service android:name="MyAudioService"> 
<intent-filter> 
<action 
android:name-"introduction.android.AudioServiceDemo.MY AUDIO SERVICE"/» 
Xcategory android:name-"android.intent.category.DEFAULT"/» 
</intent-filter> 
</service> 
</application> 


</manifest> 


其 中 : 


<service android:name="MyAudioService"> 
<intent-filter> 
<action 
android:name-"introduction.android.AudioServiceDemo.MY AUDIO SERVICE"/> 
«category android:name-"android.intent.category.DEFAULT"/» 
</intent-filter> 
</service> 


定义 了 名 为 MyAudioService 的 Service, iZ Service 314473 “introduction.android. AudioServiceDemo. 
MY _AUDIO_SERVICE” 的 动作 进行 处 理 。 
实例 AudioServiceDemo 中 MyAudioService.java 的 代码 如 下 : 


package introduction.android.AudioServiceDemo; 
import java.io.IOException; 


import android.app.Service; 
import android.content.Intent; 
import android.media.MediaPlayer; 
import android.os.IBinder; 
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该 服务 启动 Mediaplayer， 并 播放 存放 于 SD 卡 中 的 “sdcard/music/white.mp3” 文 件 。 


6.3.4 ”录音 程序 


Android SDK 提供 了 使 用 MediaRecorder 类 实现 对 音频 和 视频 进行 录制 的 功能 。 MediaRecorder 
对 象 在 运行 过 程 中 存在 多 种 状态 ， 其 状态 转化 如 图 6.5 所 示 。 
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Error occurs or EN 


an invalid call 









setAudioSource()/ 
etVideoSource() 







etAudioSource(/ 
setVideoSource() 


udioEncoder() 
setVideoEncoder() 
setOutputFile() 
prepare() setVideoSize() 
setVideoFrameRate() 
setPreviewDisplay() 


图 6.5 MediaRecorder 对 象 状态 转化 图 


从 图 6.5 中 可 以 看 到 : 

(1) 创建 MediaRecorder 对 象 后 处 于 Initial 状态 ，MediaRecorder 对 象 会 占用 硬件 资源 ， 因 此 
不 再 需要 时 ， 应 该 调用 release0 方 法 销毁 。 在 其 他 状态 调用 reset() 方 法 ， 可 以 使 得 MediaRecorder 
对 象 重新 回 到 Initial 状态 ， 达 到 复 用 MediaRecorder 对 象 的 目的 。 

(2) 在 Initial 状态 调用 setVideoSourceQ) 8K setAudioSource()Z Ja, MediaRecorder 将 进入 
Initialized 状态 。 对 于 音频 录制 ， 目 前 OPhone 平台 支持 从 麦克 风 或 者 电话 两 个 音频 源 录制 数据 。 
在 Initialized 状态 的 MediaRecorder 还 需要 设置 编码 格式 、 文 件数 据 路 径 、 文 件 格式 等 信息 ， 设 置 
之 后 MediaRecorder 进入 DataSourceConfigured 状态 。 

(3) 在 DataSourceConfigured 状态 调用 prepare0 方 法 ，MediaRecorder 对 象 将 进入 Prepared AR 
态 ， 录 制 前 的 状态 准备 就 绪 。 

(4) 在 Prepared 状态 调用 start0 方 法 ，MediaRecorder 进入 Recording 状态 ， 声 音 录制 可 能 只 
需 一 段 时 间 ， 这 时 MediaRecorder 一 直 处 于 录制 状态 。 

(5) 在 Recording 状态 调用 stop0 方 法 ，MediaRecorder 将 停止 录制 ， 并 将 录制 内 容 输出 到 指 
定 文件 。 

MediaRecorder 定义 了 两 个 内 部 接口 OnErrorListener 和 OnInfoListener 来 监听 录制 过 程 中 的 错 
误 信息 。 例 如 ， 当 录制 的 时 间 长 度 达到 了 最 大 限制 或 者 录制 文件 的 大 小 达到 了 最 大 文件 限制 时 ， 系 
统 会 回调 已 经 注册 的 OnInfoListener 接口 的 onInfoQ77 i£ 
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使 用 MediaRecorder 类 进行 音频 录制 的 基本 步骤 如 下 : 


€x 


建立 MediaRecorder 类 的 对 和 象 。 


MediaRecorder recorder-new MediaRecorder () + 


en 
recorder. 
en 
recorder 
ar 
recorder 
ais 
recorder. 
Er 

recorder. 
ar 


recorder. 


Is 
ks 


recorder. 


EIo 


recorder. 


设置 音频 来 源 。 
setAudioSource (MediaRecorder.AudioSource.MIC) ; 


设置 音频 输出 格式 。 


.setOutputFormat (MediaRecorder.OutputFormat.THREE GPP) ; 


设置 音频 编码 方式 。 


-setAudioEncoder (MediaRecorder.AudioEncoder.AMR NB) ; 


设置 音频 文件 的 保存 位 置 及 文件 名 。 
setOutputFile (PATH NAME) ; 

将 录音 器 置 于 准备 状态 。 

prepare () ; 

启动 录音 器 。 


start(); 


音频 录制 。 
音频 录制 完成 ， 停 止 录音 器 。 


stop(); 
释放 录音 器 对 象 。 


release(); 


实例 AudioRecord 演示 了 使 用 MediaRecorder 类 对 音频 进行 录制 的 过 程 ， 运 行 效果 如 图 6.6 所 示 。 


| | AudioRecordDemo 





图 6.6 AudioRecord 的 运行 效果 
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该 运行 效果 对 应 的 布局 文件 main.xml 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: layout_width="fill parent" 
android: layout_height="fill_ parent" 
android:orientation="vertical"> 


<TextView 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android: layout_marginLeft="70dp" 
android: layout_marginTop="30dp" 
android:text="@string/hello” /> 


<LinearLayout 
android: layout_width="fill parent" 
android: layout_height="wrap_ content" 
android: layout_marginTop="30dp" 
android: orientation="horizontal"> 


<ImageButton 
android: id="@+id/st" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout marginLeft-"20dp" 
android:scaleType-"fitXY" 
android:src-"Gdrawable/st" /> 


<ImageButton 

android: id="@+id/stop” 

android:layout width-"wrap content" 
ayout height-"wrap content" 
android:layout marginLeft-"30dp" 
android:scaleType-"fitXY" 
android:src-"Gdrawable/stop" /> 








android: 





</LinearLayout> 
<LinearLayout 
android: layout_width="fill_ parent" 
android:layout height-"wrap content" 
android:orientation-"horizontal"» 


<TextView 
android: layout_marginLeft="21dp" 
android: layout_width="wrap_ content" 
android: layout_height="wrap_ content" 
android:text="@string/start" /> 
<TextView 
android: layout_marginLeft="43dp" 
android: layout_width="wrap content" 
android:layout height-"wrap content" 
android:text-"6string/stop" /> 


</LinearLayout> 


第 6 章 多 媒体 开发 


177 





<TextView 
android:id="@+id/sttext" 
android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
/> 
</LinearLayout> 


实例 AudioRecord  AndroidManifest.xml 文件 的 代码 如 下 : 





<?xml version-"1.0" encoding="utf-8"?> 


«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 





package-"introduction.android.AudioRecord" 
android:versionCode-"1" 


android:versionName-"1.0"» 


<uses-sdk android:minSdkVersion-"14" /> 
<uses-permission android:name-"android.permission.RECORD AUDIO"/> 
<application 
android: icon="@drawable/ic_ launcher" 
android: label="@string/app_name"> 
<activity 
android: name=".AudioRecordDemo” 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name-"android.intent.action.MAIN" /> 
<category android:name-"android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 


</manifest> 


其 中 : 
<uses-permission android:name-"android.permission.RECORD AUDIO"/» 
表明 进行 音频 录制 的 用 户 权限 。 
i| AudioRecord 中 AudioRecordDemo.java 的 代码 如 下 : 





package introduction.android.AudioRecord; 


import java.io.File; 
import java.io. IOException; 


import introduction.AudioRecord.audioRecorder.R; 


import android.app.Activity; 

import android.media.MediaRecorder; 
import android.os.Bundle; 

import android.os.Environment; 

import android.util.Log; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.ImageButton; 

import android.widget.TextView; 

import android.widget.Toast; 
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public class RudioRecordDemo extends Activity implements OnClickListener { 
/** Called when the activity is first created. */ 
private ImageButton st, stop; 
private TextView sttext; 
private MediaRecorder mRecorder; 
private File recordPath; 
private File recordFile; 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


st= (ImageButton) findViewById (R.id.st) ; 
stop- (ImageButton) findViewById (R.id.stop) ; 
sttext- (TextView) findViewById (R.id.sttext) ; 
st.setOnClickListener (this) ; 
stop.setOnClickListener (this) ; 
) 
public void start()( 
if (checkSDCard()) ( 
recordPath-Environment.getExternalStorageDirectory(); 
File path-new File (recordPath.getPath()+File.separator 
*"audioRecords") ; 
if (!path.mkdirs()) { 
Log.d ("audioRecorder"，" 创 建 目录 失败 ") ; 
return; 
d 
} else { 
Toast.makeText (AudioRecordDemo.this, "SDcard 未 连接 "， 
Toast.LENGTH LONG) .show(); 
return ; 


try ( 
recordFile-File.createTempFile (String.valueOf ("myrecord "), ".amr", recordPath) ; 
) catch (IOException e) { 
Log.d ("audioRecorder", "文件 创建 失败 ") ; 


mRecorder=new MediaRecorder(); 


// 设置 麦克 风 


mRecorder.setAudioSource (MediaRecorder.AudioSource.MIC) ; 


// 输出 文件 格式 


mRecorder.setOutputFormat (MediaRecorder.OutputFormat.DEFAULT) ; 


// 音频 文件 编码 
mRecorder.setAudioEncoder (MediaRecorder.AudioEncoder.DEFAULT) ; 


// 输出 文件 路 径 


mRecorder.setOutputFile (recordFile.getAbsolutePath()) 7 


// 开始 录音 

try { 
mRecorder.prepare () 7 
mRecorder.start (); 

} catch (IllegalStateException e) { 
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该 应 用 程序 运行 后 ， 首 先 检测 SD 卡 是 否 插入 手机 中 。 若 SD 卡 在 手机 中 ， 则 会 在 SD 卡 的 
audioRecords 目录 下 创建 以 “myRecord ”为 前 组 、 以 “.amr” 为 后 级 的 临时 文件 ， 并 将 录音 内 容 
写 入 该 文件 中 。 


635 ”后台 录制 音频 


结合 Android 系统 提供 的 相关 API， 借 助 于 MediaRecorder 类 ， 可 以 实现 一 些 比较 有 意思 的 功 
能 。 比 如 ， 在 手机 中 监听 短信 的 功能 ， 当 有 符合 特定 要 求 的 短信 到 来 时 ， 启 动 相应 服务 在 后 台 进 行 
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录音 ， 进 而 将 手机 变化 为 一 个 可 远程 控制 的 录音 机 。 

本 小 节 在 此 处 不 去 实现 短信 内 容 验 证 功能 ， 而 只 演示 通过 短信 远程 启动 后 台 服 务 并 进行 录音 
的 功能 ， 读 者 可 以 举一反三 。 

实例 AudioRecordService 演示 了 该 功能 。 该 实例 实现 了 BroadcastReceiver 类 的 子 类 ， 对 手机 
短信 息 进 行 监听 。 当 有 短信 来 时 ， 该 BroadcastReceiver 开始 在 后 台 录 音 并 将 录音 文件 保存 在 SD 卡 
中 ， 同 时 启动 一 个 线程 进行 计时 ， 当 录音 进行 一 分 钟 后 ， 关 闭 录 音程 序 。 

实例 AudioRecordService 中 MessageReceiver.java 的 代码 如 下 : 


package introduction.android.audioServiceRecord; 


import 
import 


import 
import 
import 
import 
import 
import 
import 


public 


java.io.File; 
java.io. IOException; 


android.content .BroadcastReceiver; 
android.content .Context; 
android.content.Intent; 
android.media.MediaRecorder; 
android.os.Bundle; 
android.os.Environment; 
android.util.Log; 


class MessageReceiver extends BroadcastReceiver ( 


private File recordPath; 

private File recordFile; 

private MediaRecorder mRecorder; 

private long startTime; 

@Override 

public void onReceive (Context context, Intent intent) { 


// TODO Auto-generated method stub 
if (intent.getAction() .equals ("android.proider.Telephony.SMS RECEIVER")) 
t 
recordBegin(); 
new Thread (timing) .start(); 


private Runnable timing-new Runnable() { 


private long currentTime=System.currentTimeMillis(); 
@Override 
public void run(){ 
// TODO Auto-generated method stub 
while (currentTime<startTime+60*1000) { 
try { 
Thread.sleep (1000) ; 
} catch (InterruptedException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 
Y 
recordStop(); 
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private void recordBegin() { 
// TODO Auto-generated method stub 
startTime-System.currentTimeMillis(); 
recordPath-Environment.getExternalStorageDirectory(); 
File path-new File (recordPath.getPath()+File.separator 

*"audioRecords") ; 
recordPath-path; 
Ery i 
recordFile-File.createTempFile (String.valueOf ("myrecord ") , 


.amr", 
recordPath) ; 
} catch (IOException e) { 
Log.d ("audioRecorder"，" 文 件 创建 失败 ") ; 


mRecorder-new MediaRecorder () ; 
mRecorder.setAudioSource (MediaRecorder.AudioSource.MIC) ; 
mRecorder.setOutputFormat (MediaRecorder.OutputFormat.DEFAULT) ; 
mRecorder.setAudioEncoder (MediaRecorder.AudioEncoder.DEFAULT) ; 
mRecorder.setOutputFile (recordFile.getAbsolutePath()) ; 
try ( 

mRecorder.prepare(); 

mRecorder.start(); 
) catch (IllegalStateException e) ( 

e.printStackTrace(); 
) catch (IOException e) { 

e.printStackTrace(); 


} 

protected void recordStop() { 
// TODO Auto-generated method stub 
mRecorder.stop(); 
mRecorder. release (); 
mRecorder=null; 


) 
由 于 实例 AudioRecordService 涉及 接收 短信 和 使 用 录音 功能 ,因此 需要 在 AndroidManifest. xml 
文件 中 声明 相应 的 用 户 权限 。AndroidManifestxml 文件 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="introduction.android.audioServiceRecord" 





android:versionCode="1" 
android:versionName="1.0"> 
<uses-sdk android:minSdkVersion="14" /> 
<application 
android:icon="@drawable/ic_launcher" 
android:label="@string/app_name"> 
<receiver android:name="MessageReceiver"> 
<intent-filter> 
<action 
android:name="android.provider.Telephony.SMS_RECEIVED"/> 
</intent-filter> 
</receiver> 
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</application> 
«uses-permission android:name-"android.permission.RECEIVE SMS"» 
«/uses-permission» 
<uses-permission android:name-"android.permission.RECORD AUDIO"> 
«/uses-permission» 
</manifest> 


6.4.1 Android N 支持 的 视频 文件 


Android N 支持 的 视频 格式 如 表 6.2 所 示 。 
表 6.2 Android N 支持 的 视频 文件 


格式 / 编码 。 ”| 支持 的 文件 类 型 


3GPP ( ao MPEG-4 ( a 
H.264 AVC 
er es C.ts, AAC audio 人 not seekable, Android 3.0+) 


IMPEG-4SP___[3GPP ( 一 | 
[WebM (webm); Matrskamv | 





6.4.2 ”视频 播放 器 


音频 播放 相 比 ， 视 频 播放 需要 使 用 视觉 组 件 将 影像 显示 

出 来 。 在 Android SDK 中 提供 了 多 种 播放 视频 文件 的 方法 。 例 
如 ， 可 以 用 VideoView 或 SurfaceView 来 播放 视频 ， 其 中 使 用 
VideoView 组 件 播放 视频 最 为 方便 。 

实例 VideoPlayDemo 演 示 了 使 用 android.widget.VideoView 
组 件 进行 视频 播放 的 方法 ， 运 行 效果 如 图 6.7 所 示 。 

实例 VideoPlayDemo 中 含有 两 个 Activity, 其 中 PlayVideo 
含有 VideoView 组 件 对 象 , 用 于 播放 视频 。 视频 文件 存放 在 SD 
卡 中 ， 路 径 为 “Movies/movie.3gp”。 而 VideoPlayAcitvity 为 主 
Activity， 用 于 启动 PlayVideo。 


实例 VideoPlayDemo 中 VideoPlayActivity.java 的 代码 如 
T: 图 6.7 VideoPlayDemo 的 运行 效果 





package introduction.android.playvideo; 


import introduction.android.playvideo.R; 
import android.app.Activity; 
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import 


import 
import 
import 


import 


Public 


android.content.Intent; 


android.os.Bundle; 
android. view.View; 
android.view.View.OnClickListener; 


android.widget.Button; 


class VideoPlayAcitvity extends Activity ( 


/** Called when the activity is first created. */ 
private Button button01; 


@Override 
public void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState) ; 

setContentView (R.layout.main) ; 

button01- (Button) findViewById (R.id.button01) ; 
button01.setOnClickListener (new buttonListener()) ; 


class buttonListener implements OnClickListener ( 


) 


@Override 

public void onClick (View v) { 
// TODO Auto-generated method stub 
Intent intent=new Intent (VideoPlayAcitvity.this, PlayVideo.class) ; 
VideoPlayAcitvity.this.startActivity (intent) ; 


实例 VideoPlayDemo 中 PlayVideo java 的 代码 如 下 : 


package introduction.android.playvideo; 


import 
import 
import 
import 
import 
import 
import 


introduction.android.playvideo.R; 
android.app.Activity; 
android.net.Uri; 
android.os.Bundle; 
android.widget.MediaController; 
android.widget.Toast; 
android.widget.VideoView; 


public class PlayVideo extends Activity { 
private VideoView videoView; 
private MediaController mc ; 
private String path ; 
@Override 
public void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState) ; 

setContentView (R.layout.other) ; 

videoView- (VideoView) this.findViewById (R.id.videoView) ; 
path-"sdcard/Movies/movie.3gp"; 

mc-new MediaController (this) ; 
videoView.setMediaController (mc) ; 

videoView.setVideoPath (path) ; 
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videoView.setOnCompletionListener (new OnCompletionListener () { 
QOverride 
public void onCompletion (MediaPlayer arg0) { 
// TODO Auto-generated method stub 
finish(); 


De 
videoView.requestFocus(); 
videoView. start (); 


) 


其 中 ，MediaController 类 为 Android SDK 提供 的 视频 控制 器 ， 用 于 显示 播放 时 间 ， 对 播放 视 
频 进行 控制 。 通 过 VideoView 类 的 setMediaController() 方 法 可 以 将 视频 控制 器 和 VideoView 类 结合 
在 一 起 ， 对 VideoView 中 播放 的 视频 进行 控制 ， 大 大 降低 了 编码 强度 。 由 于 要 播放 的 视频 为 放置 
在 SD 卡 中 的 “Movies/movie.3gp” 文 件 ，VideoView 组 件 使 用 setVideoPath0 方 法 即 可 指定 该 文件 ， 
并 通过 start0 方 法 进行 播放 。 
videoView.setOnCompletionListener (new OnCompletionListener () { 
@Override 
public void onCompletion (MediaPlayer arg0) { 


// TODO Auto-generated method stub 
finish(); 


De 


这 行 代码 指定 了 videoView 组 件 的 视频 播放 完成 事件 的 触发 器 , 当 视 频 播放 完成 后 , 关闭 当前 
Activity» 

PlayVideo 使 用 的 布局 为 R.layout.other， 该 布局 中 含有 VideoView 组 件 ， 其 所 对 应 的 XML 5c 
件 other.xml 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: orientation="vertical" 
android: layout_width="fill_ parent" 
android: layout_height="fill_ parent" 
> 
<VideoView 
android: id="@+id/videoView”" 
android: layout_width="320px" 
android: layout_height="240px" 
/> 
</LinearLayout> 


实例 VideoPlayDemo  AndroidManifest.xml 文件 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
:android-"http://schemas.android.com/apk/res/android" 
package-"introduction.android.playvideo" 





«manifest xmln 


android:versionCode-"1" 
android:versionName-"1.0"» 


«uses-sdk android:minSdkVersion-"10" /» 
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<application android:icon="@drawable/icon" android:label="@string/app name"> 
«activity android:name-".VideoPlayAcitvity" 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name-"android.intent.action.MAIN" /> 
<category android:name-"android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
<activity android:name="introduction.android.playvideo.PlayVideo"></activity> 


</application> 
</manifest> 


此 外 ，VideoView 也 支持 网 络 流 媒 体 的 播放 ， 只 需 将 VideoView 的 setVideoPath( 方 法 替换 为 
setViewURIO， 并 指定 对 应 的 URI 即 可 。 需 要 注意 的 是 ， 并 不 是 所 有 的 MPA 和 3GP 文件 都 可 以 被 
VideoView 组 件 播放 ， 只 有 使 用 progressive streamable 模式 转化 的 影片 才 可 以 被 播放 。 播 放 网 络 流 
媒体 文件 时 ， 需 要 在 AndroidManifest.xml 文件 中 添加 相应 权限 : 


<uses-permission android:name="android.permission.INTERNET"/> 
<uses-permission android:name="android.permission.WAKE LOCK"/> 


其 中 ，android.permission.INTERNET 权限 使 当前 应 用 程序 可 以 访问 网 络 资源 ;android. 
permission. WAKE LOCK 权限 使 当前 应 用 程序 运行 时 ， 手 机 不 会 进入 休眠 状态 ， 以 便于 视频 播放 。 

使 用 SurfaceView 组 件 播放 视频 的 方法 也 不 复杂 , 而 且 更 加 灵活 。 实 例 MediaPlayerVideoDemo 
演示 了 使 用 SurfaceView 和 MediaPlayer 组 件 播放 视频 的 方法 ， 运 行 效果 如 图 6.8 所 示 。 





| MediaPlayervideoDemo 





播放 暂停 mW ”停止 





图 6.8 MediaPlayerVideoDemo 的 运行 效果 


对 应 的 布局 文件 main.xml 的 内 容 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
android: orientation="vertical"> 
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<SurfaceView 
android: id="@+id/surfaceViewl" 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android: layout_weight="1.01" /> 


<LinearLayout 
android: id="@+id/linearLayout1" 
android: layout_width="match parent" 
android: layout_height="wrap content" android:gravity="center"> 


<Button 
android: id="@+id/buttonl" 
android: layout_width="wrap content" 
android:layout height-"wrap content" 
android:text="##2" /> 





«Button 
android: id="@+id/button2" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android:text-" Ef)" /> 








«Button 
android: id="@+id/button3" 
android: layout_width="wrap content" 
android:layout height-"wrap content" 
android:text-" Ef" /> 








«Button 
android: id="@+id/button4" 
android: layout_width="wrap content" 





android: layout_height="wrap content" 
android:text-"ff/f" /> 


</LinearLayout> 


</LinearLayout> 


实例 MediaPlayerVideoDemo 的 配置 文件 AndroidManifest.xml 的 内 容 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
«manifest xmlns:android="http://schemas. android. com/apk/res/android" 
package="introduction.android.videoPlayDemo" 
android: versionCode="1" 
android: versionName="1.0"> 
«uses-sdk android:minSdkVersion="14" /> 
<application 
android: icon="@drawable/ic_launcher" 
android: label="@string/app name"» 
<activity 
android: label="@string/app name" 
android: 





ame-". VideoPlayDemoActivity"> 
<intent-filter> 
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<action android:name-"android.intent.action.MAIN" /> 


«category android:name="android. intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 


</manifest> 


实例 MediaPlayerVideoDemo 中 的 主 Activity 文件 VideoPlayDemoActivity Java 的 代码 如 下 : 


package introduction.android.videoPlayDemo; 


import java.io. IOException; 

import android.app.Activity; 
import android.media.AudioManager; 
import android.media.MediaPlayer; 
import android.os.Bundle; 

import android.util.Log; 

import android.view.SurfaceHolder; 
import android.view.SurfaceView; 
import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 


public class VideoPlayDemoActivity extends Activity { 
/** Called when the activity is first created. */ 
private Button playbtn; 
private Button pausebtn; 
private Button replaybtn; 
private Button stopbtn; 
private SurfaceView surview; 
private SurfaceHolder surHolder; 
private MediaPlayer mp; 
private String path="sdcard/movies/movie.3gp"; 
protected boolean pause=false; 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
surview- (SurfaceView) this.findViewById (R.id.surfaceViewl) ; 
surHolder-surview.getHolder(); 
surHolder.setType (SurfaceHolder.SURFACE TYPE PUSH BUFFERS) ; 
mp-new MediaPlayer (); 
mp.setOnCompletionListener (new MediaPlayer.OnCompletionListener () { 


@Override 

public void onCompletion (MediaPlayer mp) { 
// TODO Auto-generated method stub 
Log.i ("mediaplayer", "播放 完成 ") ; 


Ds 
playbtn- (Button) this.findViewById (R.id.buttonl) ; 
playbtn.setOnClickListener (new OnClickListener () { 
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64.3 ”拍照 程序 


在 之 前 的 章节 中 介绍 过 拍照 程序 ， 是 通过 Intent 调用 Android 系统 提供 的 照相 机 程序 实现 的 。 
其 实 Android SDK 提供 了 直接 操作 移动 设备 摄像 头 的 android.hardware.Camera 类 , 通过 该 类 的 相关 
API， 可 以 直接 操作 Android 手机 中 的 摄像 头 ， 以 方便 开发 自己 的 拍照 程序 。 

使 用 Camera 类 访问 移动 设备 的 摄像 头 , 需要 在 应 用 程序 的 AndroidManifest.xml 文件 中 做 以 下 


声明 : 


<uses-permission android:name-"android.permission.CAMERA" /> 


<uses-feature android:name-"android.hardware.camera" /> 


使 用 Camera 类 进行 拍照 的 步骤 如 下 : 
E) 使 用 Camera.open0 方 法 获取 Camera 对 象 实例 。 


人 2 使 用 Camera.getParameters0 方 法 获取 当前 相机 的 相关 设置 。 
CX303 根据 需要 使 用 Camera.setParameters() 方 法 设置 相机 的 相关 参数 。 


CXX04 根据 需要 使 用 CamerasetDisplayOrientation()i£ E 
相机 正 向 。 

C€X305 使 用 Camera.setPreviewDisplay0 方 法 为 相机 设置 一 
个 用 于 显示 相机 图 像 的 Surface。 

Eoo 使 用 Camera.startPreview0 启 动 预览 。 

€07 使 用 Camera.takePicture0 方 法 进行 拍照 。 

Eis 进行 拍照 后 ,预览 视图 会 停止 。 使 用 
Camera.startPreview0 方 法 重新 启动 预览 。 

Eo 使 用 Camera.stopPreview0 停 止 预览 。 

Eo 使 用 Camerarelease( 方 法 释放 相机 对 象 。 应 该 在 应 
用 程序 的 onPause() 方 法 中 释放 相机 对 象 , 在 onResume(0 方 法 中 重 
新 打开 相机 对 象 。 


实例 MyCameraDemo 演示 了 使 用 Camera 类 进行 拍照 的 过 


程 ， 该 应 用 程序 的 运行 效果 如 图 6.9 所 示 。 
该 视图 所 使 用 布局 文件 main. xml 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

















| Mycamerapemo 


使 用 android.hardware.Camera 进 行 拍照 实例 


打开 摄像 头 ”拍摄 ”关闭 摄像 头 


图 6.9 MyCameraDemo 的 运行 效果 


<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 


android: layout_width="fill parent" 
android: layout_height="fill parent" 


android:orientation-"vertical"» 


<TextView 
android: layout_width="fill parent" 
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android: layout_height="wrap content" 
android:text="@string/hello" /> 


<SurfaceView 
android: id="@tid/surfaceViewl" 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android: layout_weight="0.58" /> 


<LinearLayout 
android: id="@+id/linearLayout1" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:gravity-"center"» 





«Button 
android: id="@+id/buttonl" 
android: layout_width="wrap content" 





android: layout_height="wrap content" 
android: text="@string/opBtn"/> 


<Button 
android: id="@+id/button2" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="@string/play" /> 


<Button 
android: id="@+id/button3" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android:text="@string/cloBtn" /> 
</LinearLayout> 


</LinearLayout> 


实例 MyCameraDemo 使 用 到 的 资源 文件 string.xml 的 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«resources» 


«string name="hello">{#/H android.hardware.Camera 进行 拍照 实例 </string> 


<string name="app name">MyCameraDemo</string> 
<string name="opBtn"> 打 开 摄 像 头 </string> 
«string name="play"> 拍 摄 </string> 

<string name="cloBtn"> 关 闭 摄像 头 </string> 





</resources> 


由 于 实例 MyCameraDemo 中 涉及 将 拍摄 的 照片 保存 到 SD 卡 中 的 功能 ， 因 此 需要 在 该 工程 的 
AndroidManifest.xml 文件 中 声明 相应 权限 。 该 文件 内 容 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 


«manifest xmlns:android="http://schemas. android. com/apk/res/android" 


package-"introduction.android.myCameraDemo" 
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android: versionCode="1" 


android: versionName="1.0"> 


<uses-sdk android:minSdkVersion-"14" /> 
«uses-feature android:name-"android.hardware.camera"/» 
«uses-permission android:name="android.permission.CAMERA"/> 
«uses-permission android:name-"android.permission.WRITE EXTERNAL STORAGE" /> 


«application 
android:icon-"édrawable/ic launcher" 
android:label-"8string/app name"? 

«activity 
android: label="@string/app name" 
android:name=".MyCameraDemoActivity"> 
<intent-filter> 
<action android:name-"android.intent.action.MAIN" /> 


<category android:name="android.intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 


</manifest> 


实例 MyCameraDemo 的 主 Activity 为 MyCameraDemoActivity， 其 代码 如 下 : 


package introduction.android.myCameraDemo; 


import java.io.BufferedOutputStream; 
import java.io.File; 

import java.io.FileNotFoundException; 
import java.io.FileOutputStream; 
import java.io. IOException; 


import android.app.Activity; 

import android.graphics.Bitmap; 

import android.graphics.BitmapFactory; 
import android.graphics.PixelFormat; 
import android.hardware.Camera; 

import android.hardware.Camera.Parameters; 
import android.hardware.Camera.PictureCallback; 
import android.os.Bundle; 

import android.util.Log; 

import android.view.SurfaceHolder; 

import android.view.SurfaceView; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 


public class MyCameraDemoActivity extends Activity { 
private Button opbtn; 
private Button playbtn; 
private Button clobtn; 
private SurfaceView surfaceView; 


private SurfaceHolder surfaceHolder; 
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其 中 ，openCamera() 方 法 用 于 打开 当前 设备 的 相机 ， 并 通过 : 
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设置 相机 的 相关 参数 ， 以 用 于 照片 拍摄 。 
通过 以 下 代码 : 
surfaceView= (SurfaceView) this.findViewById (R.id.surfaceViewl) ; 


surfaceHolder-surfaceView.getHolder(); 
camera.setPreviewDisplay (surfaceHolder) ; 


将 布局 中 的 SurfaceView 组 件 设 置 为 相机 的 预览 窗口 。 
由 于 在 拍摄 照片 后 ， 预 览 视图 会 自动 停止 预览 而 显示 拍摄 的 照片 ， 因 此 在 本 例 中 人 为 将 照片 
显示 时 间 设 定 为 1s， 然 后 重新 启动 预览 。 相 关 代码 如 下 : 


camera.takePicture (null, null, jpeg) ; 
try { 
Thread.sleep (1000) ; 
} catch (InterruptedException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 





) 


camera.startPreview(); 


6.4.5 ”录制 视频 


视频 录制 也 可 以 通过 MediaRecorder 类 完成 ， 其 步骤 与 音频 录制 基本 相同 ， 只 是 添加 了 一 些 对 
视频 进行 处 理 的 操作 。 

视频 录制 的 基本 步骤 如 下 : 

eD) 调用 Camera.open0 方 法 打开 摄像 头 。 

CX302 调用 Camera.setPreviewDisplay0 连 接 预 览 窗口 ,以便 将 从 摄像 头 获取 的 图 像 放 置 到 预 
览 窗口 中 显示 出 来 。 

CX303 调用 Camera.startPreview0 启 动 预览 ， 显 示 摄 像 头 拍摄 到 的 图 像 。 

CXX04 使 用 MediaRecorder 进行 视频 录制 。 


1. 使 用 Camera.unlock0 方 法 解锁 摄像 关 ， 以 使 MediaRecorder 获得 对 摄像 头 的 使 用 权 。 
2. 配置 MediaRecorder。 
(1) 建立 MediaRecorder 类 的 对 象 ， 并 设置 音频 源 和 视频 源 : 


MediaRecorder recorder-new MediaRecorder (); 
recorder.setAudioSource (MediaRecorder.AudioSource.MIC) ; 
recorder.setVideoSource (MediaRecorder.VideoSource.CAMERA) ; 


(2) 设置 视频 的 输出 和 编码 格式 。 在 Android 2.2 (API Level 8) 以 上 版 本 的 SDK 中 ， 可 以 
直接 调用 MediaRecorder.setProfile 方法 进行 相关 配置 : 
recorder.setProfile (CamcorderProfile.get (CamcorderProfile.QUALITY LOW)) ; 
HH, MediaRecorder.setProfile() 773 N Android 2.2 (API Level 8) 之 后 MediaRecorder 类 新 提 
供 的 方法 ， 通 过 CamcorderProfile 对 象 可 用 于 对 MediaRecorder 进行 相关 设置 。 
CamcorderProfile 为 预先 定义 好 的 一 组 视频 录制 相关 配置 信息 ，Android SDK 共 定 义 了 14 种 
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CamcorderProfile 配置 ,如 CamcorderProfile. QUALITY HIGH, CamcorderProfile. QUALITY LOW, 
CamcorderProfile. QUALITY TIME LAPSE 1080P ^&. H}, QUALITY LOW 和 QUALITY HIGH 
两 种 配置 是 所 有 的 摄像 头 都 支持 的 ,其 他 配置 则 根据 硬件 性 能 决定 。 每 一 种 配置 都 涉及 文件 输出 格 
式 、 视 频 编码 格式 、 视 频 比 特 率 、 视 频 帧 率 、 视 频 的 高 和 宽 、 音 频 编码 格式 、 音 频 的 比特 率 、 首 频 
采样 率 和 音频 录制 的 通道 数 几 个 方面 。 通 过 使 用 这 些 预 定义 配置 能 够 降低 代码 复杂 度 , 提高 编码 效 
G) 设置 录制 的 视频 文件 的 保存 位 置 及 文件 名 : 
MediaRecorder.setOutputFile (PATH_NAME) ; 
(4) 使 用 MediaRecorder.setPreviewDisplay() 77 148 1 MediaRecorder 的 视频 预览 窗口 。 
需要 注意 的 是 ， 以 上 配置 过 程 必须 按照 顺序 进行 ， 否 则 会 发 生 错 误 。 
3. 将 录像 器 置 于 准备 状态 : 
MediaRecorder.prepare(); 
4. 启动 录像 器 : 
MediaRecorder.start(); 
5. 进行 视频 录制 ; 
Gio 视频 录制 完成 后 ， 可 使 用 以 下 方法 停止 视频 录制 。 


1. 停止 录像 器 : 
MediaRecorder.stop(); 

2. 重 置 录 像 器 的 相关 配置 : 
MediaRecorder. reset () 

3. 释放 录像 器 对 象 : 


MediaRecorder.release(); 





BB viaeonecorderbemo 
使 用 


4. 调用 Cameralock() 方 法 锁定 摄像 头 。 从 Android N 
开始 ， 该 调用 也 不 再 必需 ， 除 非 MediaRecorder.prepare() 方 
法 失败 。 

C€X306 调用 Camera.stopPreview0 方 法 停止 预览 。 

CX307 调用 Camerarelease() 方 法 释放 摄像 头 。 


另外 ， 在 Android N 系统 下 ，Cameraunlock0 方 法 和 
Camera.lock()77 i: i] H Android 框架 来 完成 。 
实例 VideoRecorderDemo 演示 了 使 用 MediaRecorder 








进行 视频 录制 的 过 程 ， 该 实例 的 运行 效果 如 图 6.10 所 示 。 nue. an samen 
实例 VideoRecorderDemo 使 用 的 布局 文件 main.xml 的 
内 容 如 下 : 图 6.10 VideoRecorderDemo 的 运行 效果 


<?xml version="1.0" encoding="utf-8"?> 
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其 对 应 的 资源 文件 strings.xml 的 内 容 如 下 : 
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由 于 实例 VideoRecorderDemo 中 涉及 音频 录制 、 使 用 摄像 头 、 向 SD 卡 写 文件 等 操作 ， 因 此 需 
要 在 该 工程 的 AndroidManifestxml 文件 中 声明 相应 权限 。 该 文件 内 容 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 





package-"introduction.android.videoRecorderDemo" 
android:versionCode-"]" 
android:versionName-"].0"» 


<uses-sdk android:minSdkVersion="14" /> 

«uses-permission android:name="android.permission.CAMERA" /» 
<uses-feature android:name-"android.hardware.camera" /> 
"android. hardware.camera.autofocus" /> 





<uses-feature android:name: 
<uses-permission android:name="android.permission.RECORD AUDIO"/> 
<uses-permission android:name="android.permission.WRITE EXTERNAL STORAGE" /> 


<application 
android: icon="@drawable/ic launcher" 
android: label="@string/app_name"> 





<activity 
android: label="@string/app name" 
android:name-".VideoRecorderDemoActivity"» 





<intent-filter> 
<action android:name-"android.intent.action.MAIN" /> 


<category android:name="android. intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 


</manifest> 


实例 VideoRecorderDemo 的 主 Activity 为 VideoRecorderDemoActivity， 其 代码 如 下 : 


package introduction.android.videoRecorderDemo; 


import java.io.IOException; 

import android.app.Activity; 

import android.graphics.PixelFormat; 
import android.hardware.Camera; 

import android.hardware.Camera. Parameters; 
import android.media.MediaRecorder; 
import android.os.Bundle; 

import android.util.Log; 

import android.view.SurfaceHolder; 

import android.view.SurfaceView; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 


public class VideoRecorderDemoActivity extends Activity ( 
private Button opbtn; 
private Button playbtn; 
private Button clobtn; 


private SurfaceView surfaceView; 
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private SurfaceHolder surfaceHolder; 
private Camera camera; 
private MediaRecorder videoRecorder; 
private String myVideofilepath-"/sdcard/myVideo.3gp"; 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
opbtn- (Button) this. findViewById (R.id.buttonl) ; 
playbtn- (Button) this. findViewById (R.id.button2) ; 
clobtn= (Button) this. findViewById (R.id.button3) ; 
videoRecorder-new MediaRecorder () ; 
surfaceView- (SurfaceView) this.findViewById (R.id.surfaceViewl) ; 
surfaceHolder-surfaceView.getHolder(); 
surfaceHolder.addCallback (new SurfaceHolder.Callback()( 


@Override 

public void surfaceDestroyed (SurfaceHolder holder) { 
// TODO Auto-generated method stub 
Log.i ("videoRecorder", "surface destroyed.") ; 
surfaceHolder=null; 
stopRecording(); 
releaseCamera (); 


@Override 

public void surfaceCreated (SurfaceHolder holder) { 
// TODO Auto-generated method stub 
Log.i ("videoRecorder", "surface created.") ; 
surfaceHolder=holder; 


GOverride 
public void surfaceChanged (SurfaceHolder holder, int format, 
int width, int height) { 
// TODO Auto-generated method stub 
Log.i ("videoRecorder", "surface changed.") ; 
surfaceHolder-holder; 


195 
opbtn.setOnClickListener (new OnClickListener () { 


@Override 

public void onClick (View arg0) { 
// TODO Auto-generated method stub 
openCamera (); 


De 
playbtn.setOnClickListener (new OnClickListener() { 


@override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
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benginRecording(); 


We 
clobtn.setOnClickListener (new OnClickListener () { 


GOverride 

public void onClick (View v) ( 
// TODO Auto-generated method stub 
stopRecording(); 
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@Override 
protected void onPause() { 
// TODO Auto-generated method stub 
super. onPause () 7 
stopRecording():; 
releaseCamera(); 


protected void stopRecording()( 

// TODO Auto-generated method stub 
Log.i ("videoRecorder", "stopRecording....") ; 
if (videoRecorder!-null) { 
videoRecorder.stop(); 
videoRecorder. reset (); 
videoRecorder. release (); 
videoRecorder=null; 
camera. lock(); 

y 
} 
private void releaseCamera() { 
if (camera !=null) { 
camera.release(); // release the camera for other applications 


camera-null; 


) 
protected void benginRecording() { 

// TODO Auto-generated method stub 
Log.i ("videoRecorder","beginRecording.") ; 
// 给 摄像 头 解 锁 
camera.unlock (); 
/ /MediaRecorder 获取 到 摄像 头 的 访问 权 
videoRecorder.setCamera (camera) ; 
// 设 置 视频 录制 过 程 中 所 录制 的 音频 来 自 手机 的 麦克 风 
videoRecorder.setAudioSource (MediaRecorder.AudioSource.CAMCORDER) ; 
// 设 置 视 频 源 为 摄像 头 
videoRecorder.setVideoSource (MediaRecorder.VideoSource.CAMERA) ; 
// 设 置 视频 录制 的 输出 文件 格式 为 3gp 文件 
videoRecorder.setOutputFormat (MediaRecorder.OutputFormat.THREE GPP) ; 
// 设 置 音频 编码 方式 为 AAC 


videoRecorder.setAudioEncoder (MediaRecorder.AudioEncoder.AAC) ; 
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// 设置 录制 的 视频 编码 方式 为 8.264 
videoRecorder.setVideoEncoder (MediaRecorder.VideoEncoder.H264) ; 
// 设置 视频 录制 的 分 辨 率 ， 必 须 放 在 设置 编码 和 格式 的 后 面 ， 否 则 报错 
videoRecorder.setVideoSize (176, 144) ; 
// 设置 录制 的 视频 帧 率 ， 必 须 放 在 设置 编码 和 格式 的 后 面 ， 否 则 报错 
videoRecorder.setVideoFrameRate (20) ; 
if (!checkSDCard()) ( 
Log.e ("videoRecorder", "未 找到 SD 卡 ! ") ; 
return; 
) 
videoRecorder.setOutputFile (myVideofilepath) ; 
videoRecorder.setPreviewDisplay (surfaceHolder.getSurface()) ; 
try ( 
videoRecorder.prepare(); 
} catch (IllegalStateException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 
) catch (IOException e) ( 
// TODO Auto-generated catch block 
e.printStackTrace(); 
) 
videoRecorder.start(); 
) 
private void openCamera() { 
// TODO Auto-generated method stub 
Log.i ("videoRecorder","openCamera.") ; 
try { 
camera-Camera.open(); // attempt to get a Camera instance 
) catch (Exception e) { 
// Camera is not available (in use or does not exist) 
Log.e ("camera", "open camera error!") ; 
e.printStackTrace(); 
return; 
} 
try { 
camera.setPreviewDisplay (surfaceHolder) ; 
} catch (IOException e) { 
// TODO Auto-generated catch block 
Log.e ("camera", "preview failed.") ; 
e.printStackTrace(); 
} 
camera.startPreview(); 
) 
private boolean checkSDCard() { 
// 判断 SD 存储 卡 是 否 存在 
if (android.os.Environment.getExternalStorageState().equals ( 
android.os.Environment.MEDIA MOUNTED)) ( 
return true; 
) else { 
return false; 


} 
该 实例 中 ， 在 对 MediaRecorder 进行 设置 时 ， 没 有 使 用 : 
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videoRecorder.setProfile (CamcorderProfile.get (CamcorderProfile.QUALITY LOW)) ; 


而 是 使 用 以 下 代码 对 MediaRecorder 进行 设置 : 


// 设 置 视频 录制 的 输出 文件 格式 为 3gp 文件 
videoRecorder.setOutputFormat (MediaRecorder.OutputFormat.THREE GPP) ; 
// 设 置 音频 编码 方式 为 AAC 
videoRecorder.setAudioEncoder (MediaRecorder.AudioEncoder.AAC) ; 
// 设置 录制 的 视频 编码 方式 为 8.264 
videoRecorder.setVideoEncoder (MediaRecorder.VideoEncoder.H264) ; 
// 设置 视频 录制 的 分 辨 率 ， 必 须 放 在 设置 编码 和 格式 的 后 面 ， 否 则 报错 
videoRecorder.setVideoSize (176, 144) ; 
// 设置 录制 的 视频 帧 率 ， 必 须 放 在 设置 编码 和 格式 的 后 面 ， 否 则 报错 
videoRecorder.setVideoFrameRate (20) ; 


6.5 小 结 


本 章 介绍 了 Service 的 相关 知识 ,涉及 Service 的 生命 周期 和 使 用 方法 .Service 是 一 种 与 Activity 
类 似 的 程序 ， 不 同 的 是 它 没 有 用 户 界面 ， 只 能 在 后 台 运 行 。Service 适合 执行 一 些 较为 耗 时 的 工作 。 
当 Service 被 启动 后 ， 它 会 一 直 在 后 台 运 行 ， 直 到 调用 Service 的 stopService() 方 法 才 终 止 服 务 。 例 
如 ， 本 章 中 实现 的 后 台 音 频 播 放 程序 ， 当 离开 音频 播放 的 主 界面 时 ， 音 乐 还 是 会 一 直播 放 。 

Service 的 功能 不 仅 如 此 ， 在 日 后 的 学 习 过 程 中 ， 会 接触 到 更 多 的 和 Service 相关 的 开发 方法 。 

本 章 还 简单 介绍 了 BroadcastReceiver 的 使 用 方法 。 BroadcastReceiver 是 Android 系统 中 的 广播 
接收 者 ， 通 过 BroadcastReceiver 可 以 轻松 实现 对 Android 系统 中 特定 事件 的 处 理 ， 例 如 当 有 来 电 、 
电池 电量 发 生变 化 等 事件 发 生 时 ， 可 以 使 程序 员 通 过 自己 开发 的 应 用 程序 对 事件 进行 处 理 。 

此 外 ， 本 章 介绍 了 多 媒体 开发 相关 的 知识 ， 如 视频 播放 、 音 频 播 放 、 视 频 和 音频 的 录制 、 使 
用 照相 机 拍照 等 ， 其 中 涉及 Android 系统 的 硬件 编程 。 读 者 可 以 举一反三 ， 对 Android 系统 提供 的 
硬件 资源 进行 更 多 的 开发 。 


=H 


66 习 题 


. 尝试 开发 自己 的 音频 播放 器 。 

. 尝试 开发 自己 的 视频 播放 器 。 

. 尝试 开发 自己 的 照相 机 应 用 程序 。 

. 怎么 才能 实现 远程 控制 其 他 手机 进行 后 台 录 音 ? 

- 使 用 MediaRecorder 进行 视频 录制 时 ， 能 否 不 出 现 界面 而 在 后 台 录制 视频 ? 


Ak WNG 


数据 存储 


无 论 是 桌面 应 用 程序 还 是 Android 手机 应 用 程序 ， 都 会 涉及 数据 的 存储 。 本 章 将 详细 介绍 在 
Android 中 存储 数据 的 相关 知识 。 

在 Android 中 应 用 程序 存储 的 数据 (包括 文件 ) 都 属于 应 用 程序 私有 ， 但 同时 也 提供 了 
ContentProviders (数据 共 享 )， 方 便 应 用 程序 将 私有 的 数据 分 享 给 其 他 程序 使 用 。 其 中 数据 存储 方 
式 共 分 为 5 种 ， 分 别 为 : 

SharedPreferences, 

内 部 存储 (Internal Storage ). 
外 部 存储 (External Storage ). 
SQLite 数据 库存 储 。 

网 络 存 储 。 


其 中 ， 网 络 存储 在 本 质 上 是 对 网 络 资源 的 获取 和 访问 ， 其 相关 内 容 会 在 网 络 编程 章节 中 进行 
介绍 ， 本 章 主要 介绍 前 4 种 ， 其 中 内 部 存储 和 外 部 存储 统称 为 文件 存储 。 此 外 ，Android 系统 框架 
提供 了 ContentProvider 来 实现 各 种 应 用 程序 间 持久 化 数据 的 共享 。 


7.1 SharedPreferences 


SharedPreferences 是 Android 系统 提供 的 一 个 通用 的 数据 持久 化 框架 ， 用 于 存储 和 读 取 
key-value 类 型 的 原始 基本 数据 对 ， 目 前 仅 支持 boolean、float、int、long 和 string 等 基本 类 型 的 存 
储 ， 对 于 自 定 义 的 复合 数据 类 型 ， 是 无 法 使 用 SharedPreferences 进行 存储 的 。 
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7.1.1 SharedPreferences 简介 


SharedPreferences 主要 用 于 存储 系统 的 配置 信息 ， 类 似 于 Windows 下 常用 的 ini 文件 ， 例 如 
上 次 登录 的 用 户 名 、 上 次 最 后 设置 的 信息 等 ,通过 保存 上 一 次 用 户 所 做 的 修改 或 者 自 定义 参数 设 定 ， 
当 再 次 启动 程序 后 依然 保持 原 有 设置 。 它 是 用 键 值 对 的 方式 存储 的 ， 方 便 管理 写 入 和 读 取 。 

使 用 SharedPreferences 的 步骤 如 下 : 

C€X301 获取 Preferences。 每 个 Activity 默认 都 有 一 个 SharedPreferences WR, KL 
SharedPreferences 对 象 的 方法 有 两 种 : 


* SharedPreferences getSharedPreferences ( String name, int mode )。 使 用 该 方法 获取 name 指定 的 
SharedPreferences 对 象 ， 并 获取 对 该 SharedPreferences 对 象 的 读 写 控制 权 。 当 应 用 程序 中 可 
能 使 用 到 多 个 SharedPreferences 时 使 用 该 方法 。 

* SharedPreferences getPreferences ( int mode )。 当 应 用 程序 中 仅 需要 一 个 SharedPreferences 对 象 
时 ， 使 用 该 方法 获取 当前 Activity 对 应 的 SharedPreferences， 而 不 需要 指定 SharedPreferences 
的 名 字 。 

其 中 ， 参 数 mode 有 4 种 取 值 ， 分 别 是 : 

* MODE PRIVATE 默认 方式 ， 只 能 被 创建 的 应 用 程序 或 者 与 创建 的 应 用 程序 具有 相同 用 户 
ID 的 应 用 程序 访问 。 

e MODE WORLD READABLE 允许 其 他 应 用 程序 对 该 SharedPreferences 文件 进行 读 操作 。 

* MODE WORLD WRITEABLE 允许 其 他 应 用 程序 对 该 SharedPreferences 文件 进行 写 操作 。 

* MODE MULTI PROCESS 在 多 进程 应 用 程序 中 ， 当 多 个 进程 都 对 同一 个 SharedPreferences 
进行 访问 时 ， 该 文件 的 每 次 修改 都 会 被 重新 核对 。 


C€X302 调用 edit0 方 法 获取 SharedPreferences.Editor, 
SharedPreferences 通过 该 接口 对 其 内 容 进 行 更 新 。 EE SharedPreferencesDemo 
Æ 通过 SharedPreferences.Editor 接口 提供 的 put 方 " 5 Aiea wie 
法 对 SharedPreferences 进行 更 新 。 例 如 使 用 putBoolean (String 13088888888 
key, boolean value) putFloat (String key, float value) 等 方法 将 您 所 在 的 城市 
相应 数据 类 型 的 数据 与 其 key 对 应 起 来 。 beijing 
人 04 调用 SharedPreferences.Editor 的 commit0 方 法 
将 更 新 提交 到 SharedPreferences 中 。 


7.1.2 使 用 SharedPreferences 


实例 SharedPreferencesDemo 演示 了 SharedPreferences 对 
象 的 使 用 方法 。 该 实例 的 运行 效果 如 图 7.1 所 示 。 当 用 户 在 该 
实例 运行 时 ， 在 文本 框 中 输入 电话 号 码 和 所 在 城市 ， 例 如 
13088888888 和 beijing， 单 击 回 退 按钮 退出 应 用 程序 时 ， 该 应 图 7.1 SharedPreferencesDemo 界面 
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用 程序 将 相关 信息 写 入 其 对 应 的 SharedPreferences 中 。 当 用 户 再 次 启动 该 应 用 程序 时 , 之 前 填写 到 
文本 框 内 的 信息 会 被 从 SharedPreferences 中 读 取 并 显示 出 来 ， 以 方便 用 户 修 改 。 

实例 SharedPreferencesDemo 中 的 布局 文件 main.xml 中 放置 了 三 个 TextView 和 两 个 EditText， 
其 中 两 个 EditText 按照 TextView 的 要 求 输入 电话 号 码 和 城市 。 其 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
fill parent" 
android:layout height-"fill parent" 
android:orientation-"vertical"» 
<TextView 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android:text="{#/] Shared Preferences 存储 程序 信息 ” /> 
<TextView 
android: layout_width="fill parent" 
android: layout_height="wrap_ content" 
android: text=" SH Bid 5%: "/> 
<EditText 
android: id="@+id/phone_text" 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
android:hint=" 输 入 电话 号 码 "/> 
<TextView 





android: layout_width= 


android: layout_width="fill_ parent" 
android:layout height-"wrap content" 
android:text=" 您 所 在 的 城市 "/> 

<EditText 

android: id="@+id/city_text” 

android: layout_width="fill_ parent" 
android:layout height-"wrap content" 
android:hint=" 输 入 城市 名 称 "/> 

</LinearLayout> 


实例 SharedPreferencesDemo 中 AndroidManifest.xml 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android="http: //schemas.android.com/apk/res/android" 
package-"introduction.android.SharedPreferencesDemo" 
android:versionCode-"1" 
android:versionName-"1.0"» 
<uses-sdk android:minSdkVersion-"14" /> 
<application 
android: icon="@drawable/ic launcher" 
android: label="@string/app_name"> 
<activity 
android:name-".SharedPreferencesDemo" 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
«category android:name-"android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
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</manifest> 


实例 SharedPreferencesDemo 中 SharedPreferencesDemo java 的 代码 如 下 : 


package introduction.android.SharedPreferencesDemo; 


import 
import 
import 
import 
import 
import 
public 


javax.security.auth.PrivateCredentialPermission; 
introduction.android.SharedPreferencesDemo.R; 
android.app.Activity; 
android.content.SharedPreferences; 
android.os.Bundle; 

android.widget.EditText; 

class SharedPreferencesDemo extends Activity { 


private EditText phoneText,cityText; 


private String phone,city; 

public static final String SET INFO-"SET Info"; 
public static final String PHONE-"PHONE"; 

public static final String CITY-"CITY"; 

@Override 

public void onCreate (Bundle savedInstanceState) { 


} 


super.onCreate (savedInstanceState) ; 

setContentView (R.layout.main) ; 

phoneText- (EditText) findViewById (R.id.phone text) ; 
cityText- (EditText) findViewById (R.id.city text) ; 
/+ 获取 Shared Preferences 对 象 */ 

SharedPreferences setinfo-getPreferences (Activity.MODE PRIVATE) ; 
/* 取 出 保存 的 电话 号 码 和 地 址 信息 */ 

phone=setinfo.getString (PHONE,"") ; 
city-setinfo.getString (CITY, "") ; 

/* 将 取出 的 信息 分 别 放 在 对 应 的 EditText 中 */ 
phoneText.setText (phone) ; 

cityText.setText (city) ; 


@Override 
protected void onStop() { 


) 


SharedPreferences setinfo-getPreferences (Activity.MODE PRIVATE) ; 
setinfo.edit() 

.putString (PHONE, phoneText.getText().toString()) 

.putString (CITY,cityText.getText ().toString()) 

„commit (); 

super.onStop():; 


该 Activity 在 启动 时 通过 onCreate0 方 法 从 其 SharedPreferences 中 获取 相应 数据 ， 在 onStop() 
方法 中 将 相应 数据 写 入 SharedPreferences 中 ， 其 中 : 


SharedPreferences setinfo-getPreferences (Activity.MODE PRIVATE) ; 


用 于 获取 当前 Activity 默认 的 SharedPreferences 对 象 ， 该 对 象 没有 名 字 。 当 然 ， 也 可 以 通过 
getSharedPreferences(String name, int mode) 方 法 来 创建 并 获取 一 个 带 有 名 字 的 SharedPreferences. 当 
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EE 后 ， 可 以 在 应 用 程序 的 包 路 径 下 ， 即 data/data/<your package 


name>/shared_prefs 文件 夹 下 找到 该 文件 。 
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7.2.1 文件 存储 方式 简介 


Android 的 文件 存储 方式 分 为 两 种 : 内 部 存储 和 外 部 存储 。 
1. 内 部 存储 


内 部 存储 是 指 将 应 用 程序 的 数据 以 文件 方式 存储 到 设备 内 存 中 。 以 内 部 存储 方式 存储 的 文件 
属于 其 所 创建 的 应 用 程序 私有 ， 其 他 应 用 程序 无 权 进 行 操作 。 当 创建 的 应 用 程序 被 卸载 时 ， 其 内 部 
存储 的 文件 也 随 之 被 删除 。 当 内 部 存储 器 的 存储 空间 不 足 时 ， 缓 存 文件 可 能 会 被 删除 以 释放 空间 ， 
因此 ， 缓 存 文件 是 不 可 靠 的 。 当 使 用 缓存 文件 时 ， 自 己 应 该 维护 好 缓存 文件 ， 并 且 将 缓存 文件 限制 
在 特定 大 小 之 内 。 

使 用 文件 存储 信息 时 ， 使 用 openFileOutput 和 openFileInput 进行 文件 的 读 写 ， 这 跟 Java 中 的 
VO 程序 很 类 似 。 创 建 并 写 内 部 存储 文件 的 步骤 如 下 : 

(2801) 通过 Context.openFileOutput (String name, int mode) 方法 打开 文件 并 设 定 读 写 方式 ， 
返回 FileOutputStream。 


其 中 ， 参 数 mode 取 值 为 : 


MODE PRIVATE， 默 认 访问 方式 ， 文 件 仅 能 被 创建 应 用 程序 访问 。 

MODE APPEND， 若 文件 已 经 存在 ， 则 在 文件 末尾 继续 写 入 数据 ， 而 不 抹 掉 文件 原 有 内 容 。 
MODE WORLD READABLE， 人 允许 该 文件 被 其 他 应 用 程序 执行 读 取 内 容 操 作 。 

MODE WORLD WRITEABLE， 允 许 该 文件 被 其 他 应 用 程序 执行 写 操作 。 








C€X302 调用 FileOutputStream write0 方 法 写 入 数据 。 
©2103 调用 FileOutputStream.close0 方 法 关闭 输出 流 ， 完 成 写 操作 。 


内 部 存储 文件 的 写 文件 示例 代码 如 下 : 


String FILENAME="hello file"; 

String string="hello world!"; 

FileOutputStream fos=openFileOutput (FILENAME, Context.MODE PRIVATE) ; 
fos.write (string.getBytes()) ; 

fos.close(); 


2. 外 部 存储 


外 部 存储 是 指 将 文件 存储 到 一 些 外 部 存储 设备 上 , 例如 SD 卡 或 者 设备 内 能 的 存储 卡 ， 属 于 永 
久 性 的 存储 方式 。 外 部 存储 的 文件 不 被 某 个 应 用 程序 所 特有 ， 可 以 被 其 他 应 用 程序 共享 ， 当 将 该 外 
部 存储 设备 连接 到 计算 机 上 时 ,这些 文件 可 以 被 浏览 、 修 改 和 删除 。 因 此 ， 这 种 存储 方式 不 具有 安 
全 性 。 

由 于 外 部 存储 器 可 能 处 于 被 移 除 、 连 接 到 计算 机 、 丢 失 、 只 读 或 者 其 他 各 种 状态 ， 因 此 在 使 
用 外 部 存储 之 前 ， 必 须 使 用 Environment getExternalStorageState() 方 法 来 确认 外 部 存储 器 是 否 可 用 。 
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验证 外 部 存储 器 是 否 可 读 写 的 代码 如 下 : 


boolean mExternalStorageAvailable=false; 

boolean mExternalStorageWriteable-false; 

String state=Environment.getExternalStorageState (); 

if (Environment .MEDIA MOUNTED.equals (state)) { 
// 外 部 存储 器 可 读 写 
mExternalStorageAvailable-mExternalStorageWriteable-true; 

) else if (Environment.MEDIA MOUNTED READ ONLY.equals (state)) ( 
// 外 部 存储 器 可 读 不 可 写 
mExternalStorageAvailable=true; 
mExternalStorageWriteable=false; 

} else { 
// 外 部 存储 器 不 可 读 写 ， 处 于 其 他 状态 
mExternalStorageAvailable-mExternalStorageWriteable-false; 

) 


此 外 ， 在 程序 开发 过 程 中 还 可 以 使 用 缓存 文件 (Cache) ， 内 部 存储 和 外 部 存储 都 可 以 用 于 保 
存 缓存 文件 。 当 存储 器 的 存储 空间 不 足 时 ,缓存 文件 可 能 会 被 删除 以 释放 空间 。 因 此 ,缓存 文件 是 
不 可 靠 的 。 当 使 用 缓存 文件 时 ， 应 该 自己 维护 好 缓存 文件 ， 并 且 将 缓存 文件 限制 在 特定 大 小 之 内 。 


7.2.2 ”使 用 文件 存储 功能 


实例 FileDemo 演示 了 使 用 文件 存储 的 功能 ， 其 运行 效果 如 图 7.2 所 示 。 该 实例 将 文本 框 中 输 
入 的 内 容 存 储 到 名 为 text 的 文件 中 。 当 该 应 用 程序 再 次 启动 时 , 可 以 从 text 文件 写 入 的 内 容 中 读 取 
并 显示 出 来 。 本 实例 使 用 内 部 存储 方式 ， 读 者 可 以 在 data/data/<your package name>/files 目录 下 找 
到 名 为 text 的 文件 。 本 实例 没有 将 文件 放置 到 SD 卡 中 ， 读 者 可 以 自行 实现 将 文件 保存 在 SD 卡 中 
的 操作 。 


FileDemo 


储 程 


hello,world. 


保存 信息 。” 读 取 信息 保存 信息 ike 


数据 保存 成 功 保存 的 数据 是 : hello,world. 





图 7.2 FileDemo 界面 


实例 FileDemo 的 布局 文件 main.xml 中 放置 了 两 个 TextView、 一 个 EditText 和 两 个 Button, 
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其 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: layout_width="fill parent" 
android: layout_height="fill parent” 
android: orientation="vertical"> 
<TextView 
android: layout_width="fill parent" 
android: layout_height="wrap content" 


使 用 文件 存储 程序 信息 ” /> 





android:text- 
<TextView 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android:text=" 输 入 您 存储 的 信息 "/> 
<EditText 
android: id="@+id/phone_text” 
android: layout_width="fill parent" 
android: layout_height="wrap_ content" 
android:hint=" 输 入 保存 的 信息 "/> 
<LinearLayout 
android: layout_width="wrap_ content" 
android:layout height-"wrap content" 
android: orientation="horizontal"> 
<Button 
android: id="@+id/SaveButton” 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text=" 保 存 信息 "/> 
<Button 
android: id="@+id/LoadButton” 
android: layout_width="wrap_content" 
android:layout height-"wrap content" 
android:text=" 读 取信 息 "/> 
</LinearLayout> 


</LinearLayout> 


实例 FileDemo 中 AndroidManifest.xml 文件 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"introduction.android.fileDemo" 
android:versionCode-"1" 
android:versionName-"1.0"» 
«uses-sdk android:minSdkVersion-"14" /> 
«application 
android:icon-"G(drawable/ic launcher" 
android: label="@string/app_name"> 
<activity 
android:name="introduction. android. fileDemo.FileDemo" 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


«category android:name="android. intent .category. LAUNCHER” /> 
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实例 FileDemo 中 FileDemo java 的 代码 如 下 : 








7.3 SQLite 


前 面 我 们 介绍 了 用 SharedPreferences 和 文件 存储 信息 的 方法 ， 但 是 当 频 繁 大 量 地 使 用 数据 存 
储 时 ， 就 要 用 到 数据 库 来 管理 信息 数据 。 在 Android 中 ， 我 们 使 用 SQLite 数据 库 ， 在 应 用 中 也 常 
常会 用 到 SQLite 来 存储 、 管 理 、 维 护 数据 ， 本 节 将 详细 介绍 SQLite 的 使 用 方法 。 





7.8.1 SQLite 数据库 简 介 


Android 通过 SQLite 数据 库 引擎 来 实现 结构 化 数据 存储 。Android 系统 提供 对 SQLite 数据 库 
的 完全 支持 , 在 数据 库 应 用 程序 中 ,任何 类 都 可 以 通过 名 字 对 已 创建 的 数据 库 进 行 访问 , 但 是 在 应 
用 程序 之 外 不 可 以 。 

SQLite 是 一 个 轻 量 级 数据 库 , 第 一 个 版 本 诞生 在 2000 年 5 月 , 其 遵守 ACID 的 关联 式 数据 库 
管理 系统 ， 最 初 就 是 为 嵌入 式 设 计 的 ， 其 占用 资源 非常 少 ， 在 内 存 中 只 需要 占用 几 百 千 字 节 (KB) 
的 存储 空间 ， 这 也 是 Android 采用 SQLite 数据 库 的 重要 原因 之 一 。 同 时 ，SQLite 还 支持 事务 处 理 
功能 ， 根 据 相 关 资 料 可 知 ，SQLite 的 处 理 速度 比 MySQL. PostgreSQL 等 著名 的 开源 数据 库 管理 
系统 更 快 。 另 外 ，SQLite 数据 库 不 像 其 他 的 数据 库 〈 如 Oracle) ， 它 没有 服务 器 进程 ，SQLite 通 
过 文件 保存 数据 库 ， 该 文件 是 跨 平 台 的 ,可 以 自由 复制 。 一 个 文件 就 是 一 个 数据 库 ， 数据库 名 称 即 
文件 名 ; 数据 库 里 面 可 以 包含 多 个 表格 ,在 每 个 表格 中 可 以 添加 多 条 记录 ,但 记录 没有 名 称 ; 记录 
可 以 由 多 个 字段 组 成 ， 每 个 字段 都 要 有 相对 应 的 值 ， 每 个 值 都 必须 指定 类 型 。 基 于 SQLite 自身 的 
先天 优势 ， 其 在 嵌入 式 领 域 中 得 到 了 广泛 应 用 。 

SQLite 支持 SQL 语言 ， 由 SQL 编译 器 、 内 核 、 后 端 以 及 附件 组 成 。SQLite 通过 利用 虚拟 
机 和 虚拟 数据 库 引 擎 (VDBE) ， 使 调试 、 修 改 和 扩展 SQLite 的 内 核 变 得 更 加 方便 。 

Android 在 运行 时 (run-time) 集成 了 SQLite， 所 以 每 个 Android 应 用 程序 都 可 以 使 用 SQLite 
数据 库 ， 在 Android 开发 中 使 用 SQLite 相当 简单 。 但 是 ， 由 于 JDBC 会 消耗 太 多 的 系统 资源 ， 
所 以 JDBC 对 于 手机 这 种 内 存 受 限 的 设备 来 说 并 不 合适 。 因 此 ，Android 提供 了 一 些 新 的 API 来 使 
用 SQLite 数据 库 ， 在 Android 开发 中 ， 我 们 需要 学 习 使 用 这 些 API。 另 外 需要 了 解 的 是 ， 数 据 库 
存储 在 data/< 项 目 文件 夹 >/databases/ 目 录 下 。 

操作 SQLite 数据 的 步骤 如 下 : 

C270) 创建 SQLite 数据 库 。Android 系统 推荐 的 创建 SQLite 数据 库 的 方法 是 创建 实现 
SQLiteOpenHelper 接口 的 子 类 ， 并 且 重 写 onCreate0 方 法 ， 在 该 方法 中 执行 用 于 创建 SQLite 数据 库 
的 命令 。 所 创建 的 数据 库 被 放置 在 /data/data/<your package name> /database 目录 下 ， 例 如 : 

















public class DictionaryOpenHelper extends SQLiteOpenHelper { 
private static final int DATABASE VERSION-2; 
private static final String DICTIONARY TABLE NAME-"dictionary"; 
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// 创 建 数据 库 的 SQL 语句 
private static final String DICTIONARY_TABLE CREATE= 
"CREATE TABLE "+DICTIONARY TABLE NAME+" ("+ 
KEY_WORD+" TEXT, "+ 
KEY_DEFINITION+" TEXT) ;"; 
DictionaryOpenHelper (Context context) [ 
super (context, DATABASE NAME, null, DATABASE VERSION) ; 
) 
@override 
public void onCreate (SQLiteDatabase db) { 
db.execSQL (DICTIONARY TABLE CREATE) ; // 执 行 SQL 语句 
) 
) 


Mo 获取 数据 库 对 象 。 通 过 实现 SQLiteOpenHelper 接口 的 类 的 对 象 ， 调 用 
getWiitableDatabase0 和 getReadableDatabase() 方 法 ， 可 以 返回 所 创建 数据 库 的 SQLiteDatabase WR. 

C€X303 对 数据 库 进行 操作 。SQLiteDatabase 对 象 提供 了 对 数据 库 进行 操作 的 一 系列 方法 ， 例 
如 query, insert, delete. update 等 ， 进 而 对 SQLite 数据 库 进行 读 写 等 操作 。 

CE 对 数据 库 的 查询 操作 会 返回 一 个 Cursor 对 象 ， 通 过 该 对 象 可 以 从 返回 的 结果 中 读 取 
出 行 、 列 信息 。 


7.3.2 SQLite 数据 库 操作 


Android 提供 了 创建 和 使 用 SQLite 数据 库 的 API。Android SDK 提供 了 一 系列 对 SQLite 数据 
库 进 行 操作 的 类 和 接口 ， 这 里 我 们 简单 介绍 一 下 。 
© SQLiteDatabase 类 。SQLiteDatabase 是 一 个 数据 库 访 问 类 ， 此 类 封装 了 一 系列 数据 库 操作 的 
API， 使 其 可 以 对 数据 进行 CRUD 操作 ， 即 添加 、 查 询 、 更 新 、 删 除 等 。 一 些 常用 的 操作 数 
据 库 的 方法 如 表 7.1 所 示 。 


表 7.1 SQLiteDatabase 常用 方法 


方法 名 称 方法 描述 
openOrCreateDatabase (String path,SQLiteDatabase.CursorFactory factory ) 打开 或 创建 数据 库 
insert (String table,String nullColumnHack,ContentValues values ) 添加 一 条 记录 
delete (String table.String whereClause,String[] whereArgs ) 删除 一 条 记录 
query (String table, String[] columns, String selection, String[] selectionArgs, 
String groupBy, String having, String orderBy ) 

update (String table,ContentValues values.String whereClause,String[] whereArgs ) 修改 记录 

execSQL (String sql) 执行 一 条 SQL 语句 
closeO 关闭 数据 库 








查询 一 条 记录 

















© SQLiteOpenHelper X. SQLiteOpenHelper 是 一 个 抽象 类 ， 用 来 创建 和 版 本 更 新 。 
SQLiteOpenHelper 的 子 类 通过 getReadableDatabase() 和 getWritableDatabase(0) 方 法 来 获取 
SQLiteDatabase 实例 对 象 ， 并 保证 以 同步 方式 访问 。 通 常情 况 下 ，getReadableDatabase0 和 
getWritableDatabase(O 都 是 创建 或 者 打开 一 个 可 写 数据 库 ， 并 返回 相同 的 对 象 。 只 有 在 某 些 情 
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况 下 ， 例 如 磁盘 空间 满 了 ， 或 者 数据 库 只 能 以 只 读 方式 打开 的 时 候 ，getReadableDatabaseO 
方法 才 会 以 查询 方式 打开 数据 库 。 其 一 般 的 用 法 是 定义 一 个 类 继承 之 ， 并 实现 其 抽象 方法 来 
创建 和 更 新 数据 库 ， 其 常见 的 方法 如 表 7.2 所 示 。 


表 7.2 SQLiteOpenHelper 常用 方法 


方法 描述 
构造 方法 ， 一 般 是 要 传递 一 个 要 创建 的 数据 库 名 称 


方法 名 称 
SQLiteOpenHelper ( Context context,String name, 


CursorFactory factory, int version) 























onCreate ( SQLiteDatabase db) 创建 数据 库 时 调用 
Ss € SQLiteDatabase db,int oldVersion,int 版 本 更 新 时 调用 
newVersion) 

getReadableDatabase() 创建 或 打开 一 个 只 读数 据 库 
getWritableDatabase() 创建 或 打开 一 个 读 写 数据 库 


* Cursor 接口 .Cursor 是 一 个 游标 接口 ,在 数据 库 中 使 用 时 作为 返回 值 , 相 当 于 结果 集 ResultSet, 
它 提供 了 遍历 查询 结果 的 方法 。Cursor 游标 的 一 些 常用 方法 如 表 7.3 所 示 。 


表 7.3 Cursor 游标 常用 方法 














方法 名 称 方法 描述 

close() 关闭 游标 ， 释 放 资 源 

copyStringToBuffer(int columnIndex, CharArrayBuffer buffer) | 在 缓冲 区 中 检索 请 求 的 列 的 文本 ， 并 将 其 存储 

getColumnCount() 返回 所 有 列 的 总 数 

getColumnIndex(String columnName) 返回 指定 列 的 名 称 ， 如 果 不 存在 ， 就 返回 -1 

— ——M cokumnName) PARES 回 指定 列 的 名 称 ， 如 果 不 存在 ， 将 
抛 出 异常 

getColumnName(int columnIndex) 从 给 定 的 索引 返回 列 名 

getColumnNames() 返回 一 个 字符 串 数组 的 列 名 

getCount() 返回 Cursor 中 的 行 数 

moveToFirst() 移动 光标 到 第 一 行 

moveToLast() 移动 光标 到 最 后 一 行 

moveToNext() 移动 光标 到 下 一 行 

moveToPosition(int position) 移动 光标 到 一 个 绝对 的 位 置 

moveToPrevious() 移动 光标 到 上 一 行 





这 些 方法 的 使 用 可 以 通过 创建 数据 库 、 创 建 表 和 执行 SQL 语句 的 过 程 一 一 进行 介绍 。 


ED 打开 或 创建 数据 库 。openOrCreateDatabase0) 方 法 会 自动 检测 要 打开 的 数据 库 是 否 存 
在 ， 如 果 存 在 就 打开 ， 否 则 创建 一 个 数据 库 。 若 该 方法 运行 成 功 ， 则 返回 一 个 SQLiteDatabase WR, 
否则 抛 出 异常 FileNotFoundException。 下 面 为 创建 名 为 “sie.db” 的 数据 库 的 代码 : 


SQLiteDatabase database-SQLiteDatabase.openOrCreateDatabase ("/data/data/sie.db",null) ; 


C€Xx30 创建 数据 表 。 使 用 SQLiteDatabase 的 execSQL( 方 法 执行 SQL 语句 ， 便 能 创建 一 个 
表 。 下 面 创建 一 个 表 ， 其 中 有 三 个 属性 : id 为 主键 并 自动 增加 ，name 为 姓名 ，number 为 编号 ， 相 
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关 代码 如 下 : 


String table="create table sietexttable (_id integer primary key autoincrement, 

name text, number text) "; 

database.execSQL (table) ; 

eo 插入 数据 。 使 用 SQLiteDatabase 的 insert (String table,String nullColumnHack, 
ContentValues values) 方法 ， 第 一 个 参数 是 表 名 称 ， 第 二 个 参数 是 空 列 的 默认 值 ， 第 三 个 参数 是 
ContentValues 封装 的 列 的 名 称 和 对 应 的 列 值 ， 代 码 如 下 : 


ContentValues values-new ContentValues(); 
values.put ("name", "sietext01") ; 
values.put ("number", "001") ; 
database.insert ("table", null, values) ; 
Eo 删除 数据 。 使 用 SQLiteDatabase 的 delete (String tableString whereClause,String[] 
whereArgs) 方法 ， 第 一 个 参数 是 表 的 名 称 ， 第 二 个 参数 是 删除 条 件 ， 第 三 个 参数 是 条 件 值 数 组 。 
CXXos 修改 数据 。 使 用 SQLiteDatabase 的 update (String table,ContentValues values,String 
whereClause, String[] whereArgs) 方法 ， 第 一 个 参数 是 表 名 称 ， 第 二 个 参数 是 更 新 行 和 列 的 
ContentValues 类 型 的 键 值 对 ， 第 三 个 参数 是 更 新 条 件 ， 第 四 个 参数 是 更 新 的 条 件数 组 。 此 外 ， 上 述 
三 种 能 够 引起 数据 库 数据 改变 的 操作 ， 都 可 以 通过 SQLiteDatabase 的 execSQL( 方 法 来 完成 。 
人 6 查询 数据 。 在 Android 中 通过 Cursor 类 来 实现 , 使 用 SQLiteDatabase.query() 方 法 会 得 
到 一 个 Cursor WR, Cursor 用 于 指向 查询 结果 中 的 记录 。 下 面 使 用 Cursor 查询 数据 库 中 的 数据 ， 代 
码 如 下 : 
Cursor cursor-database.query ("table", null, null, null, null, null, null) ; 
/* 判 断 游标 是 否 为 空 */ 
if (cursor.moveToFirst()) { 
for (int i=0;i<cursor.getCount ();i++) { 
cursor.moveToNext () 7 
// 获 得 ID 
int id=cursor.getInt (0) ; 
// 获 得 用 户 名 
String name=cursor.getString (1) ; 


// 获 得 编号 
String number-cursor.getString (2) ; 


) 
SQLiteOpenHelper 类 是 SQLiteDataBase 的 帮助 类 ， 这 个 类 主要 用 于 打开 或 者 创建 数据 库 ， 并 
返回 数据 库 对 象 ， 同 时 对 数据 库 的 版 本 进行 管理 。 并 且 它 是 一 个 抽象 类 ， 需 要 继承 它 并 实现 里 面 的 
两 个 抽象 方法 : 
* onCreate ( SQLiteDatabase )。 在 数据 库 第 一 次 生成 的 时 候 会 调用 这 个 方法 ， 一 般 在 这 个 方法 
中 生成 数据 库 表 。 
* onUpgrade ( SQLiteDatabase,int,int )。 当 数据 库 需 要 升级 的 时 候 ， 系 统 会 主动 调用 这 个 方法 。 
一 般 在 这 个 方法 中 删除 原 有 数据 表 ， 并 建立 新 的 数据 表 。 
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7.33 SQLite 数据 库 操作 实例 


实例 MyDbDemo 演示 了 使 用 SQLiteOpenHelper 和 SQLiteDatabase 对 数据 库 进行 操作 的 过 程 ， 
其 运行 效果 如 图 7.3 所 示 。 


[a MyDbDemo 


姓名 br 


EX 21 


添加 ”修改 ”删除 ”查询 


de 34 
er 21 
ef 21 
etr 21 


qee 41 





图 73 MyDbDemo 界面 


实例 MyDbDemo 使 用 SQLiteOpenHelper 对 象 建 立 了 数据 库 文件 :mydb”, 通过 SQLiteDatabase 
对 象 对 该 数据 库 进 行 数据 的 查询 、 插 入 、 修 改 和 删除 操作 ， 并 显示 到 ListView 组 件 中 。 

实例 MyDbDemo 的 运行 界面 实际 上 由 两 个 XML 文件 组 成 ， 分 别 是 main.xml 和 listview.xml。 
其 中 main.xml 文件 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: layout_width="fill_ parent" 
android: layout_height="fill_ parent" 
android: orientation="vertical"> 


<LinearLayout 
android: layout_width="fill_ parent" 
android:layout height-"wrap content" 
android:addStatesFromChildren-"true"» 


<TextView 

android:layout width-"wrap content" 

android:layout height-"wrap content" 

android: text="#%" 

android:textColor-"?android:attr/textColorSecondary" /> 
<EditText 

android: id="@+id/et_name” 

android: layout_width="wrap_ content" 


android:layout height-"wrap content" 
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android: layout_weight="1" 
android:singleLine-"true" /> 
</LinearLayout> 
<LinearLayout 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android: addStatesFromChildren="true"> 
<TextView 
android: layout_width="wrap content" 
android:layout height-"wrap content" 
android:text=" 年 龄 " 
android:textColor-"?android:attr/textColorSecondary" 
<EditText 
android: id="@+id/et_age” 
android:layout width-"wrap content" 
layout heigh 
android: layout_weight="1" 
android:singleLine="true" /> 
</LinearLayout> 
<LinearLayout 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
android:addStatesFromChildren-"true" 
android:gravity-"center"» 
«Button 
android: id="@+id/bt_add” 
android:layout width-"wrap content" 





androi 





"wrap content" 





android:layout height-"wrap content" 
android:text=" 添 加 " 
android:onClick="addbutton"> 
</Button> 
<Button 
androi 





id="@+id/bt_modify" 
android:layout_width="wrap_content" 
layout_height="wrap_content" 
text=" 修 改 " 

android:onClick="updatebutton"> 
</Button> 

<Button 
android:id="@+id/bt_del" 
android:layout_width="wrap_content" 





android:layout_height="wrap_content" 
android:text=" 删 除 " 
android:onClick="updatebutton"> 
</Button> 
<Button 
android:id="@+id/bt_query" 
android:layout_width="wrap_content" 
android:layout_height="wrap_content" 
text=" 查 询 " 
android:onClick-"querybutton"» 
«/Button» 
</LinearLayout> 





androi 


<ListView 
android: id="@+id/listView" 


第 7 章 数据 存储 | 217 





android: layout_width="fill parent" 
android: layout_height="wrap_ content" 
android:padding-"5dip"» 
</ListView> 
</LinearLayout> 


由 代码 可 见 ，main .xml 实际 上 实现 的 是 如 图 7.4 所 示 的 效果 。 该 布局 中 放置 了 两 个 TextView、 
两 个 EditText 和 4 个 按钮 ， 在 按钮 的 下 面 是 一 个 ListView 组 件 ， 但 是 该 ListView 没有 对 显示 效果 
进行 任何 的 限制 。 





图 7.4 mainxml 界面 





网 MyDbDemo 中 listview.xml 文件 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: id="@+id/linear" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:padding="5dip"> 
<TextView 
android: id="@+id/tvID" 
android: layout_width="80dp" 
android: layout_height="wrap_content"/> 
<TextView 





android: id="@+id/tvName" 

android: layout_width="80dp" 

android: layout_height="wrap_content"/> 
<TextView 


android:i 





"@+id/tvAge” 
android: layout_width="80dp" 
android: layout_height="wrap content" /> 


</LinearLayout> 
可 见 listview.xml 布局 中 横向 放置 了 三 个 TextView 用 于 显示 数据 。 该 实例 实际 的 运行 效果 是 
使 用 listview.xml 中 的 数据 格式 替换 main.xml 中 ListView 组 件 的 数据 格式 后 实现 的 。 该 效果 通过 
LayoutInflater 类 的 对 象 进行 实现 。 
实例 MyDbDemo 中 AndroidManifestxml 文件 的 代码 如 下 : 











<?xml version="1.0" encoding="utf-8"?> 


«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
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package-"introduction.android.mydbDemo" 
android:versionCode-"1" 
android:versionName-"1.0"» 
«uses-sdk android:minSdkVersion-"14" /> 
«application 
android: icon="@drawable/ic_ launcher" 
android: label="@string/app_name"> 
<activity 
android: label="@string/app name" 
android:name=".MyDbDemoActivity"> 
<intent-filter> 
<action android:name-"android.intent.action.MAIN" /> 
<category android:name-"android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 


</manifest> 


实例 MyDbDemo 中 SQLiteOpenHelper 的 子 类 dbHelper 的 实现 代码 如 下 : 


package introduction.android.mydbDemo; 

import android.content.Context; 

import android.database.sqlite.SQLiteDatabase; 

import android.database.sqlite.SQLiteDatabase.CursorFactory; 
import android.database.sqlite.SQLiteOpenHelper; 


public class dbHelper extends SQLiteOpenHelper{ 
public static final String TB_NAME="friends"; 
public dbHelper (Context context, String name, CursorFactory factory, 
int version) { 
super (context, name, factory, version) ; 
// TODO Auto-generated constructor stub 
n 
@Override 
public void onCreate (SQLiteDatabase db) { 
// TODO Auto-generated method stub 
db.execSQL ("CREATE TABLE IF NOT EXISTS "+ 
TB_NAME+" ( id integer primary key autoincrement,"+// 
"name varchar, "+ 
"age integer"+ 
EIRINN 
} 
@Override 
public void onUpgrade (SQLiteDatabase db, int oldVersion, int newVersion) { 
// TODO Auto-generated method stub 
db.execSQL ("DROP TABLE IF EXISTS "+TB_NAME) ; 
onCreate (db) ; 


} 


子 类 dbHelper #75 [3 SQLiteOpenHelper 的 两 个 抽象 方法 onCreate0 和 onUpgrade(). 1E 
onCreate() 方 法 中 创建 了 一 个 名 为 friends 的 数据 表 ， 该 数据 表 有 id, name 和 age 三 个 字段 ， 其 中 
id 为 自 增加 主键 。onUpgrade0 方 法 实现 了 删除 现 有 数据 表 并 且 重 建 的 功能 。 
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实例 MyDbDemo 中 的 主 Activity 所 对 应 文件 MyDbDemo Activity java 的 代码 如 下 : 


package introduction.android.mydbDemo; 

import introduction.android.mydbDemo.dbHelper; 
import introduction.android.mydbDemo.R; 

import java.util.ArrayList; 

import java.util.HashMap; 

import java.util.Map; 

import android.app.Activity; 

import android.content.ContentValues; 

import android.database.Cursor; 

import android.database.sqlite.SQLiteDatabase; 
import android.os.Bundle; 

import android.util.Log; 

import android.view.View; 

import android.widget.AdapterView; 

import android.widget.Button; 

import android.widget.EditText; 





import android.widget.ListView; 
import android.widget.SimpleAdapter; 
import android.widget.TextView; 
import android.widget.Toast; 
import android.widget.AdapterView.OnItemClickListener; 
public class MyDbDemoActivity extends Activity ( 
private static String DB NAME-"mydb"; 
private EditText et name; 
private EditText et age; 
private ArrayList<Map<String, Object>>data; 
private dbHelper dbHelper; 
private SQLiteDatabase db; 
private Cursor cursor; 
private SimpleAdapter listAdapter; 
private View view; 
private ListView listview; 
private Button selBtn,addBtn, updBtn, delBtn; 
private Map<String, Object>item; 
private String selld; 
private ContentValues selCV; 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
et name- (EditText) findViewById (R.id.et name) ; 
et age- (EditText) findViewById (R.id.et age) ; 
listview- (ListView) findViewById (R.id.listView) ; 
selBtn- (Button) findViewById (R.id.bt query) ; 
Button) findViewById (R.id.bt add) ; 
updBtn- (Button) findViewById (R.id.bt modify) ; 
delBtn- (Button) findViewById (R.id.bt del) ; 
selBtn.setOnClickListener (new Button.OnClickListener () { 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
dbFindAll(); 
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private void showList(){ 
// TODO Auto-generated method stub 
listAdapter=new SimpleAdapter (this,data, 
R. layout .listview, 
new String[]{"_id", "name", "age"}, 
new int[]{R.id.tvID,R.id.tvName,R.id.tvAge}) ; 
listview.setAdapter (listAdapter) ; 
} 
// 数 据 更 新 
protected void dbUpdate() { 
// TODO Auto-generated method stub 
ContentValues values=new ContentValues(); 
values.put ("name", et name.getText().toString().trim()) ; 
values.put ("age", et age.getText().toString().trim()) ; 
String where-" id-"-*selId; 
int i-db.update (dbHelper.TB NAME, values, where, null) ; 
if (i»0) 
Log.i ("myDbDemo", "数据 更 新 成 功 ! ") ; 
else 
Log.i ("myDbDemo", "数据 未 更 新 ! ") ; 


} 
// 插 入 数据 
protected void dbAdd(){ 
// TODO Auto-generated method stub 
ContentValues values-new ContentValues(); 
values.put ("name", et name.getText().toString().trim()) ; 
values.put ("age", et age.getText().toString().trim()) ; 
long rowid-db.insert (dbHelper.TB NAME, null, values) ; 
if (rowid---1) 
Log.i ("myDbDemo", "数据 插入 失败 ! ") ; 
else 
Log.i ("myDbDemo", "数据 插入 成 功 ! "+rowid) ; 
T 
// 查 询 数据 
protected void dbFindAll()( 
// TODO Auto-generated method stub 
data.clear(); 
cursor=db.query (dbHelper.TB NAME, null, null, null, null, null, " id ASC"); 
cursor.moveToFirst(); 
while (!cursor.isAfterLast()) ( 
String id-cursor.getString (0) ; 
String name-cursor.getString (1) ; 
String age-cursor.getString (2) ; 
item-new HashMap«String,Object»(); 
item.put (" id", id) ; 
item.put ("name", name) ; 
item.put ("age", age) ; 
data.add (item) ; 
cursor.moveToNext () 7 
} 
showList(); 


} 


MyDbDemoActivity 在 onCreate0 方 法 中 调用 dbHelper 创建 了 数据 库 文件 “mydb”， 获 取 到 该 
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数据 库 的 可 写 SQLiteDatabase 对 象 ， 并 将 数据 库 中 所 有 的 数据 显示 到 listview 中 。 
MyDbDemoActivity 为 main.xml 中 的 4 个 按钮 分 别 添加 按钮 单 击 监视 器 并 进行 处 理 ， 通 过 
SQLiteDatabase 对 象 实现 对 数据 库 的 CRUD 操作 。 

其 中 : 


listAdapter-new SimpleAdapter (this,data, 
R.layout.listview, 
new String[]{"_id", "name", "age"}, 
new int[]{R.id.tvID,R.id.tvName,R.id.tvAge}) ; 
listview.setAdapter (listAdapter) ; 


这 几 行 代码 通过 SimpleAdapter 将 listview.xml 文件 中 定义 的 TextView 组 件 与 main.xml 中 的 
ListView 组 件 进 行 关联 , 这 样 就 使 main.xml 中 的 ListView 组 件 以 listview.xml 文件 中 定义 的 格式 将 
数据 显示 出 来 。 


cursor-db.query (dbHelper.TB NAME, null, null, null, null, null, 
" id ASC") ; 

cursor.moveToFirst(); 

while (!cursor.isAfterLast()) { 
String id-cursor.getString (0) ; 
String name-cursor.getString (1) ; 
String age-cursor.getString (2) ; 
item-new HashMap<String, Object>(); 
item.put ("_id", id); 
item.put ("name", name) ; 
item.put ("age", age) ; 
data.add (item) ; 
cursor.moveToNext(); 


) 


这 几 行 代码 从 friends 数据 表 中 查询 出 所 有 数据 , 并 按 _id 升序 排列 。cursor.getString0 方 法 按照 
列 将 每 条 数据 的 对 应 字段 分 别 取 出 来 ， 通 过 while 循环 将 所 有 数据 保存 到 data 中 。 


listview.setOnItemClickListener (new OnItemClickListener()( 
@Override 
public void onItemClick (AdapterView<?>parent, View v, 
int position, long id) { 
// TODO Auto-generated method stub 
Map<String, Object>listItem= (Map<String, Object>) 
listview.getItemAtPosition (position) ; 

et name.setText ((String) listItem.get ("name")) ; 
et age.setText ((String) listItem.get ("age")) ; 
selld- (String) listItem.get (" id") ; 
Log.i ("mydbDemo", "id="+selId) ; 


We 


这 几 行 代码 为 ListView 组 件 添加 了 单 击 监听 器 ， 并 对 单 击 事件 进行 了 处 理 。 当 用 户 单 击 
ListView 组 件 中 的 某 条 数据 时 ， 将 该 条 数据 的 name 和 age 字段 显示 到 main.xml 文件 的 EditText 
中 ， 并 将 该 记录 的 “ id” 值 存储 到 seld 中 ， 以 便于 对 该 条 记录 进行 操作 。 

实例 MyDbDemo 中 对 数据 库 的 CRUD 操作 分 别 通过 SQLiteDatabase 对 象 的 query. insert, 
update、delete 方法 实现 ， 此 处 不 再 描述 。 
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7.4.1 ContentProvider 简介 


ContentProvider 是 Android 的 四 大 组 件 之 一 ， 用 于 保存 和 检索 数据 ， 是 Android 系统 中 不 同 应 
用 程序 之 间 共 享 数 据 的 接口 。 在 Android 系统 中 ,应 用 程序 之 间 是 相互 独立 的 ， 分 别 运 行 在 自己 的 
进程 中 ， 相 互 之 间 没 有 数据 交换 。 若 应 用 程序 之 间 需 要 共享 数据 ， 就 要 用 到 ContentProvider。 在 
Android 系统 的 手机 中 ，ContentProvider 最 典型 的 应 用 是 ， 当 发 送 一 条 短信 时 ， 需 要 用 到 联系 人 的 
相关 信息 ,此 时 就 是 通过 ContentProvider 提供 的 接口 访问 Android 系统 中 的 电话 短 ， 并 从 中 选择 联 
系 人 。 

ContentProvider 提供 了 一 组 应 用 程序 之 间 能 相互 访问 的 接口 。 应 用 程序 通过 ContentProvider 把 当前 
应 用 中 的 数据 共享 给 其 他 应 用 程序 访问 ， 而 其 他 应 用 程序 通过 ContentProvider 对 指定 应 用 中 的 数 
据 进 行 访问 和 操作 。 

Android 系统 对 一 系列 常见 的 公用 数据 类 型 提供 了 对 应 的 ContentProvider 接口 ,例如 视频 、 音 
频 、 图 像 、 个 人 通信 信息 等 ， 都 定义 在 android.provider 包 下 。 

车 应 用 程序 开发 者 想 将 自己 的 数据 公开 给 其 他 应 用 程序 使 用 ， 有 两 种 方法 一 种 是 定义 自己 
的 ContentProvider 子 类 ， 另 一 种 是 将 当前 应 用 程序 的 数据 添加 到 已 有 的 ContentProvider 中 。 

ContentProvider 中 的 数据 在 形式 上 和 关系 数据 库 中 的 表格 很 相似 。 以 Android 系统 内 建 的 用 户 
常用 词典 所 对 应 的 ContentProvider 为 例 ，Android 系统 为 其 定义 的 名 字 为 android. 
provider.UserDictionary， 该 用 户 词 典 中 的 Word 表格 记录 了 特定 用 户 经 常 使 用 的 不 规则 单 次 的 相关 
信息 。 其 数据 格式 如 表 7.4 所 示 。 


表 7.4 ContentProvider 数据 格式 








表 头 部 分 存储 在 ContentProvider 中 ， 表 格 的 每 一 行 是 该 词典 数据 的 一 个 实例 ， 也 就 是 一 个 非 
标准 的 单词 ， 每 一 列 是 和 该 单词 相关 的 一 些 信息 ， 例 如 该 单词 的 拼写 、 使 用 者 的 id、 使 用 频率 等 ， 
.ID 起 到 了 主键 的 作用 。 

应 用 程序 通过 ContentResolver 的 对 象 访 问 ContentProvider 中 的 数据 ， 该 对 象 提 供 了 对 持久 层 
数据 的 CRUD 方法 。 每 个 Activity 都 有 一 个 ContentResolver 对 象 , 要 获取 该 对 象 , 可 以 使 用 Activity 
提供 的 getContentResolver0 方 法 。 当 然 ， 应 用 程序 要 使 用 其 他 应 用 程序 提供 的 ContentProvider， 需 
要 拥有 进行 操作 的 相应 权限 。 所 有 用 户 词典 数据 的 代码 为 : 


mCursor=getContentResolver() .query ( 
UserDictionary.Words.CONTENT URI,null,null,null,null) 
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其 所 对 应 的 权限 为 : android.permission.READ USER _DICTIONARY， 因 此 必须 在 应 用 程序 的 
AndroidManifest.xml 文件 中 添加 : 


<uses-permission android:name="android.permission.READ_USER_DICTIONARY"> 


UserDictionary. Words. CONTENT URI 指 的 是 用 户 词典 中 words 表 的 内 容 URI. 
ContentProvider 通过 URI 来 共享 数据 。URI 是 一 个 通用 资源 标志 符 ， 可 将 其 分 为 A、B、C、 
D 共 4 部 分 。 

o A: 无 法 改变 的 标准 前 级 ， 包 括 “content://”“tel://” 等 。 当 前 级 是 “content://” 时 ， 说明 在 通 
过 一 个 ContentProvider 控制 这 些 数据 。 

e B: URI 的 授权 部 分 ， —ALA ContentProvider 的 全 称 ， 它 通过 Android:authorities 属性 声明 ， 
用 于 说 明 是 哪个 ContentProvider 类 提供 这 些 数据 ， 必 须 全 部 由 小 写字 母 组 成 ， 如 
content://introduction.android.myprovider. 

o C: 路 径 ， 可 以 理解 为 需要 操作 的 数据 库 中 表 的 名 字 ， 如 “content/ introduction. 
android.myprovider /name” 中 的 name. 

© D: FUR 中 包含 表示 需要 获取 记录 的 ID， 则 返回 该 ID 对 应 的 数据 ， 若 没有 ID， 则 表示 返 
回 全 部 数据 ， 如 content:// introduction.android.myprovider /name /01。 


在 本 实例 中 ，UserDictionary.Words.CONTENT_URI 包含 所 要 访问 ContentProvider 的 标识 和 具 
体 信息 表 的 路 径 。 其 所 代表 的 完整 的 字符 串 是 “content://user_dictionary/ words”， 其 中 “content://” 
是 前 置 格式 字符 串 ， 即 A 部 分 ; “user_dictionary” 指 定 了 提供 数据 的 ContentProvider， 即 B 部 分 ; 

“words” 指 定 了 要 访问 的 数据 表 ， 即 C 部 分 。 

此 外 ，ContentProvider 允许 通过 在 URI 后 面 添加 ID 值 的 方式 访问 数据 表 中 某 一 列 数 据 ， 即 添 
加 DD 部分。 例如， 访问 用 户 词典 words 表 中 _ID=2 的 数据 的 URI 可 以 这 样 表 示 : 

Uri singleUri-ContentUri.withAppendedId ( 

UserDictionary.Words.CONTENT URI,2) ; 

其 对 应 的 完整 URI 为 : *content//user dictionary/words/2" . 

ContentProvider 定义 在 android.content 包 下 面 ， 是 一 个 抽象 类 。 定 义 一 个 Content Provider 必 

须 实现 下 面 几 个 抽象 方法 。 

* onCreate(); 该 方法 用 于 在 启动 时 初始 化 ContentProvider。 由 于 该 方法 会 在 应 用 程序 的 主线 程 
启动 时 被 调用 ， 因 此 不 应 该 执行 耗 时 的 操作 ， 以 免 延 迟 应 用 程序 的 启动 时 间 。 执 行 成 功 返回 
true， 失 败 返回 false。 

* query ( Uri,String[],String,String[],String ): 该 方法 用 于 对 Uri 指定 的 ContentProvider 进行 查询 ， 

返回 一 个 Cursor 对 象 。 

insert ( Uri, ContentValues ): 用 于 添加 数据 到 Uri 指定 的 ContentProvider 中 。 

update ( Uri, ContentValues, String, String[] );” 用 于 更 新 Uri 指定 的 ContentProvider 中 的 数据 。 
delete ( Uri, String, String[] ); 用 于 从 Uri 指定 的 ContentProvider 中 删除 数据 。 

getType (Uni): 用 于 返回 Uri 指定 的 ContentProvider 中 的 数据 的 MIME 类 型 。 


ContentResolver 提供 的 方法 和 ContentProvider 提供 的 方法 相对 应 ， 主 要 有 以 下 几 个 方法 。 
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* query ( Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder ) 用 于 
对 Uri 指定 的 ContentProvider 进行 查询 。 

* insert ( Uri uri, ContentValues values ): 用 于 添加 数据 到 Uri 指定 的 ContentProvider P. 

* delete( Uri uri, String selection, String[] selectionArgs ): 用 于 从 Uri 指定 的 ContentProvider 中 删除 数据 。 

* update ( Uri uri, ContentValues values, String selection, String[] selectionArgs ): 用 于 更 新 Uri 指 
定 的 ContentProvider 中 的 数据 。 


在 对 某 特定 ContentProvider 的 CRUD 操作 中 , 通过 ContentResolver 提供 的 CRUD 方法 将 相关 
信息 传递 给 ContentProvider， 所 提供 的 CRUD 方法 进而 对 数据 进行 操作 。 因 此 ， 在 定义 自己 的 
ContentProvider 时 ， 应 该 定义 好 该 ContentProvider 对 数据 进行 CRUD 操作 时 所 使 用 的 方法 。 





7.4.2 UriMatcher 


Android 系统 提供 了 UriMatcher 类 用 于 对 URI 的 匹配 。 使 用 步骤 为 : 首先 创建 UriMatcher 类 
对 象 ， 然后 通过 UriMatcher.addURI (String,String， int) 方法 对 其 增加 需要 匹配 的 URI 路径， 所 对 
应 的 匹配 码 由 第 三 个 参数 指定 ; 最 后 通过 UriMatcher.match (Uri) 方法 进行 匹配 ， 并 返回 匹配 码 。 
其 代码 如 下 : 


UriMatcher uriMatcher=new UriMatcher (UriMatcher.NO MATCH) ; 

// 构 建 UriMatcher 类 对 象 ， 常 量 UriMatcher.NO_MATCH 表示 不 匹配 任何 路 径 ， 返 回 码 为 -1 

// 添 加 需要 匹配 的 URI， 并 指定 匹配 时 返回 的 匹配 码 

uriMatcher.addURI ("introdcuton.android.myprovider", "text", 1) ; 

// 如 果 match () 方 法 匹配 content: //introdcuton.android.myprovider/text 路 径 ， 对 应 匹配 码 为 1 
uriMatcher.addURI ("introdcuton.android.myprovider", "text/#", 2); 

//# 号 为 通配符 ， 如 果 match () WEL content: //introdcuton.android.myprovider/text/230 
// 路 径 ， 对 应 匹配 码 为 2 

Uri uri-Uri.parse ("content://introdcuton.android.myprovider/text/10") ; 

switch (uriMatcher.match (uri)) { 


case 1: //LMBENA1 





// 执 行 相应 操作 
break; 
case 2: //DLMIBEINGA 2 
// 执 行 相应 操作 
break; 
default: // 不 匹配 
// 执 行 相 应 操作 
break; 


} 

上 述 代码 中 ，uriMatcher.addURI ("introdcuton.android.myprovider", "text/#", 2) 中 “#” 为 通 配 
符 ， 代 表 任 意 数字 ， 还 可 以 使 用 通配符 “* ”来 代表 任意 文本 。 这 句 话 表示 ， 若 传 入 的 URI 能 够 匹 
配 “content://introdcuton.android.myprovider/text/ 数 字 ” 格 式 ， 则 返回 匹配 码 2. 





7.4.8 访问 系统 提供 的 ContentProvider 


Android 系统 提供 了 很 多 ContentProvider， 以 便 在 应 用 程序 间 共 享 系统 数据 。 系 统 提供 的 
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ContentProvider 都 存放 在 androidprovider 包 下 ， 例 如 android.provider.ContactsContract 、 
android.provider.MediaStore, android.provider.CalendarContract 等 。 

本 节 以 访问 系统 联系 人 列表 为 例 ， 讲 解 如 何 通过 系统 提供 的 ContentProvider 获取 数据 。 在 
Android 2.0 (API Level 5) 之 前 ,系统 所 提供 的 联系 人 ContentProvider W android.provider. Contacts, 
从 Android 2.0 开始 ， 联 系 人 列表 相关 信息 被 存放 在 android.provider. ContactsContract 中 。 使 用 
ContactsContract 获取 系统 联系 人 列表 的 方法 与 之 前 有 所 不 同 ， 虽 然 形 式 上 较 以 前 复杂 了 一 点 ， 但 
是 可 以 获取 一 个 联系 人 的 多 个 电话 号 码 。 

实例 ContactsCPDemo 演示 了 使 用 ContactsContract 获取 系统 中 所 有 联系 人 的 名 字 和 电话 号 码 ， 
并 且 显 示 出 来 的 过 程 。 为 方便 起 见 , 假定 每 个 联系 人 仅 有 一 个 电话 号 码 , 其 运行 效果 如 图 7.5 所 示 。 














BB ContactscPDemo 
联系 人 列表 如 下 

Liu 

15555215556 


XMan 


1 


Dogy 


1331-234-5678 





图 7.5 ContactsCPDemo 界面 


该 效果 由 ListView 组 件 实现 。 实 例 ContactsCPDemo 中 布局 文件 main.xml 的 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: layout_width="fill parent" 
android: layout_height="fill_ parent" 
android: orientation="vertical"> 
<TextView 
android: layout_width="fill_ parent" 
android:layout height-"wrap content" 
android:text=" 联 系 人 列表 如 下 ;，” /> 
<ListView 
android:id="@+id/listView" 
android:layout_width="fill_parent" 
android:layout_height="wrap_content" 
android:padding="5dip"> 
</ListView> 
</LinearLayout> 


实例 ContactsCPDemo 要 访问 系统 联系 人 列表 ， 需 要 拥有 “android.permission. READ 
CONTACTS” 权 限 。 实 例 ContactsCPDemo 中 AndroidManifest.xml 文件 的 代码 如 下 : 
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<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package: 





"introduction.android.contacts" 
android:versionCode-"1" 
android:versionName-"1.0"» 
«uses-sdk android:minSdkVersion="14" /> 
<uses-permission android:name-"android.permission.READ CONTACTS"/> 
<application 
android: icon="@drawable/ic_ launcher" 
android: label="@string/app_name"> 
<activity 
android: label="@string/app name" 
android:name=".ContactsCPDemoActivity"> 
<intent-filter> 
<action android:name-"android.intent.action.MAIN" /> 
<category android:name-"android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
</manifest> 


实例 ContactsCPDemo 中 ContactsCPDemoActivity java 文件 的 代码 如 下 : 


package introduction.android.contacts; 
import java.util.ArrayList; 
import java.util.HashMap; 
import java.util.Map; 
import android.app.Activity; 
import android.database.Cursor; 
import android.os.Bundle; 
import android.provider.ContactsContract; 
import android.widget.ListView; 
import android.widget.SimpleAdapter; 
public class ContactsCPDemoActivity extends Activity { 
private SimpleAdapter listAdapter; 
private ListView listview; 
private ArrayList<Map<String, String>>data; 
private HashMap<String, String>item; 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
listview- (ListView) this.findViewById (R.id.listView) ; 
data-new ArrayList<Map<String, String>>(); 
Cursor cursor-this.getContentResolver().query (ContactsContract.Contacts.CONTENT URI, 
null, null, null, null) ; 
while (cursor.moveToNext()) { 
int idFieldIndex-cursor.getColumnIndex (ContactsContract.Contacts. ID) ; 
int id-cursor.getInt (idFieldIndex) ;// 根 据 列 名 取得 该 联系 人 的 id 
int nameFieldIndex=cursor.getColumnIndex 
(ContactsContract.Contacts.DISPLAY NAME) ; 
String name-cursor.getString (nameFieldIndex) ; 
// 根 据 列 名 取得 该 联系 人 的 name 


int numCountFieldIndex-cursor.getColumnIndex 
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(ContactsContract.Contacts.HAS PHONE NUMBER) ; 
int numCount-cursor.getInt (numCountFieldIndex) ; 
// 获 取 联系 人 的 电话 号 码 个 数 
String phoneNumber=""; 
if (numCount>0) {// 联 系 人 至 少 有 一 个 电话 号 码 
// 在 类 ContactsContract.CommonDataKinds.Phone 中 根据 id 查询 相应 联系 人 的 所 有 电话 
Cursor phonecursor=getContentResolver().query C 
ContactsContract.CommonDataKinds.Phone.CONTENT URI, 
null, ContactsContract.CommonDataKinds.Phone.CONTACT_ID+"=?", 
new String[]{Integer.toString (id) ), null); 
if (phonecursor.moveToFirst()) {// 仅 读 取 第 一 个 电话 号 码 
int numFieldIndex-phonecursor.getColumnIndex (ContactsContract. 
CommonDataKinds.Phone.NUMBER) ; 
phoneNumber-phonecursor.getString (numFieldIndex) ; 


} 
item-new HashMap<String, String>() 7 
item.put ("name", name) ; 
item.put ("phoneNumber", phoneNumber) ; 
data.add (item) ; 
} 
listAdapter=new SimpleAdapter (this,data, 
android.R.layout.simple list item 2, 
new String[]("name","phoneNumber"], 
new int[]([android.R.id.textl,android.R.id.text2]) ; 
listview.setAdapter (listAdapter) ; 


} 
其 中 : 


listAdapter-new SimpleAdapter (this,data, 
android.R.layout.simple list item 2, 
new String[] {"name", "phoneNumber"}, 
new int[]{android.R.id.text1l,android.R.id.text2}) ; 
listview.setAdapter (listAdapter) ; 


使 用 了 Android 系统 提供 的 simple list item 2 布局 ， 并 将 该 布局 应 用 到 main.xml 文件 的 ListView 
组 件 中 。 


744 自 定 义 ContentProvider 





Android 系统 支持 任意 应 用 程序 创建 自己 的 ContentProvider， 以 便于 将 应 用 程序 的 数据 对 其 他 
应 用 程序 共享 。 

创建 应 用 程序 自己 的 ContentProvider 需要 以 下 几 个 步骤 : 

ED 当前 应 用 程序 必须 具有 自己 的 持久 化 数据 ， 例 如 文件 存储 或 者 使 用 SQLite 数据 库存 储 。 

C€X302 当前 应 用 程序 需要 实现 ContentProvider 的 子 类 ， 并 通过 该 子 类 完成 对 持久 化 数据 的 
访问 。 

€X303 在 AndroidManifestxml 文件 中 使 用 <provider> 标 签 声明 当前 应 用 程序 定义 的 
ContentProvider。 此 外 ， 还 可 以 在 AndroidManifestxml 文件 中 指定 相应 的 访问 权限 ， 以 保证 该 
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ContentProvider 仅 被 具有 相应 权限 的 应 用 程序 访问 。 若 不 指定 访问 权限 ， 则 任意 其 他 应 用 程序 都 可 
以 访问 该 ContentProvider。 


在 实际 的 应 用 中 ， 为 了 方便 应 用 程序 所 定义 的 ContentProvider 被 其 他 应 用 程序 使 用 ， 通 常会 
定义 一 个 类 ， 将 ContentProvider 相关 信息 以 静态 常量 的 方式 放置 到 该 类 中 。 这 样 ， 使 用 该 
ContentProvider 的 应 用 程序 只 要 将 该 类 引用 进来 , 就 可 以 获取 该 ContentProvider 的 相关 信息 , 进而 
通过 其 对 数据 进行 操作 。 

本 节 以 7.3 节 中 使 用 的 实例 MyDbDemo 为 例 ， 为 该 实例 中 创建 的 SQLite 数据 库 mydb 中 的 
friends 数据 表 创 建 ContentProvider， 以 便于 其 他 应 用 程序 通过 该 ContentProvider 对 friends 数据 表 
中 的 数据 进行 访问 。 

在 实例 MyDbDemo 中 的 introduction.android.mydbDemo 包 下 创建 两 个 文件 ， 分 别 为 
MyDbProvider.java 和 MyFriendsDB java. MyDbProvider 继承 了 ContentProvider 类 ， 实 现 了 针对 
mydb 的 friends 数据 表 的 相关 操作 。MyFriendsDB 中 包含 涉及 MyDbProvider 的 相关 信息 。 

MyDbProvider.java 的 代码 如 下 : 





package introduction.android.mydbDemo; 
import android.content.ContentProvider; 
import android.content.ContentUris; 
import android.content.ContentValues; 
import android.content.UriMatcher; 
import android.database.Cursor; 
import android.database.sqlite.SQLiteDatabase; 
import android.database.sqlite.SQLiteQueryBuilder; 
import android.net.Uri; 
import android.util.Log; 
public class MyDbProvider extends ContentProvider ( 
private dbHelper mydbHelper; 
private static final UriMatcher myUriMatcher; 
static ( 
myUriMatcher-new UriMatcher (UriMatcher.NO MATCH) ; 
myUriMatcher.addURI (MyFriendsDB.AUTHORITY, "friends", MyFriendsDB.FRIENDS) ; 
myUriMatcher.addURI (MyFriendsDB.AUTHORITY, "friends/#", MyFriendsDB.FRIENDS ID) ; 
5 
@Override 
public int delete (Uri uri, String selection, String[] selectionArgs) { 
// TODO Auto-generated method stub 
if (myUriMatcher.match (uri) !=MyFriendsDB.FRIENDS_ID) { 
throw new IllegalArgumentException ("Wrong Insert Type: "+uri) ; 
} 
String id-uri.getPathSegments().get (1) ; 
if (selectioi 11) 
selection=MyFriendsDB.ID+"="+id; 





else 
selection=MyFriendsDB.ID+"="+id+" and "+selection; 
SQLiteDatabase db-mydbHelper.getWritableDatabase(); 
int i-db.delete (dbHelper.TB NAME, selection, selectionArgs) ; 
if (i>0) 
Log.i ("myDbDemo", "数据 更 新 成 功 ! ") ; 
else 


Log.i ("myDbDemo", "数据 未 更 新 ! ") ; 
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return i; 
p 
@override 
public String getType (Uri uri) { 
// TODO Auto-generated method stub 
switch (myUriMatcher.match (uri)) { 
case MyFriendsDB. FRIENDS: 
return MyFriendsDB.CONTENT TYPE; 
case MyFriendsDB.FRIENDS ID: 
return MyFriendsDB.CONTENT ITEM TYPE; 


default: 
throw new IllegalArgumentException ("Unknown URI get type: "+uri) ; 


b 
@Override 
public Uri insert (Uri uri, ContentValues values) { 


// TODO Auto-generated method stub 
if (myUriMatcher.match (uri) !=MyFriendsDB.FRIENDS) { 
throw new IllegalArgumentException ("Wrong Insert Type: "+uri) ; 
} 
if (values==null) { 
throw new IllegalArgumentException ("Wrong Data.") ; 
) 
SQLiteDatabase db-mydbHelper.getWritableDatabase(); 
long rowId-db.insert (MyFriendsDB.TABLE NAME, null, values) ; 
if (rowId>0) { 
Uri insertUri-ContentUris.withAppendedId (MyFriendsDB.CONTENT URI, rowId) ; 
return insertUri; 


) 


return null; 
y 
@Override 
public boolean onCreate() { 
// TODO Auto-generated method stub 
mydbHelper=new dbHelper 
(getContext(),MyFriendsDB.DATABASE NAME,null,MyFriendsDB.DATABASE VERSION) ; 
return false; 
} 
@Override 
public Cursor query (Uri uri, String[] projection, String selection, 
String[] selectionArgs, String sortOrder) { 
// TODO Auto-generated method stub 
switch (myUriMatcher.match (uri)) { 
case MyFriendsDB. FRIENDS: 
break; 
case MyFriendsDB.FRIENDS_ID: 
Log.d ("MyDbProvider", "select id") ; 
String id-uri.getPathSegments().get (1) ; 
if (selection--null) 
selection=MyFriendsDB.ID+"="+id; 
else 
selection=MyFriendsDB.ID+"="+id+" and “+selection; 
break; 


default: 
throw new IllegalArgumentException ("Unknown URI type: "+uri) ; 
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null, 


} 


if (sortOrder==null) 
sortOrder="_id ASC"; 


SQLiteDatabase db-mydbHelper.getReadableDatabase () ; 
Cursor c=db.query (MyFriendsDB.TABLE NAME, projection, selection, selectionArgs, 


null, 


sortOrder) ; 


Log.d ("MyDbProvider", ""+c.getCount ()) ; 


return c; 


) 


@Override 
public int update (Uri uri, ContentValues values, String selection, 
String[] selectionArgs) { 

// TODO Auto-generated method stub 

if (myUriMatcher.match (uri) !=MyFriendsDB.FRIENDS_ID) 

throw new IllegalArgumentException ("Wrong Insert Type: "+uri) ; 





5 
String id-uri.getPathSegments().get (1) ; 
if (selection--null) 
selection=MyFriendsDB.ID+"="+id; 


throw new IllegalArgumentException ("Wrong Data.") ; 


else 


selection=MyFriendsDB.ID+"="+id+" and "+selection; 

SQLiteDatabase db=mydbHelper.getWritableDatabase () ; 

int i-db.update (dbHelper.TB NAME, values, selection, selectionArgs) ; 
if (i»0) 
Log.i ("myDbDemo", "数据 更 新 成 功 ! ") ; 


else 


return i; 


) 


Log.i ("myDbDemo", "数据 未 更 新 ! ") ; 


MyFriendsDB.java 的 代码 如 下 : 


package introduction.android.mydbDemo; 
import android.net.Uri; 
public class MyFriendsDB { 


public 
public 
public 
public 
public 
public 
public 
public 


static 
static 
static 
static 
static 
static 
static 
static 


final 
final 
final 
final 
final 
final 
final 
final 


String AUTHORITY="introduction.android.mydbdemo.myfriendsdb"; 
String DATABASE_NAME="mydb"; 

int DATABASE_VERSION=1; 

String TABLE_NAME="friends"; 

Uri CONTENT URI-Uri.parse ("content://"+AUTHORITY+"/friends") ; 
int FRIENDS-1; 

int FRIENDS ID-2; 

String CONTENT TYPE-"vnd.android.cursor.dir/mydb.friends.all"; 





public static final String CONTENT ITEM TYPE-"vnd.android.cursor.dir/mydb.friends.item"; 
public static final String ID-" id"; 
public static final String NAME-"name"; 
public static final String AGE-"age"; 


232 | Android 7 应 用 程序 开发 教程 





这 样 ,就 定义 了 针对 mydb 的 friends 数 据 表 的 ContentProvider, 最 后 需要 在 AndroidManifest xml 
文件 中 添加 该 ContentProvider 的 相应 声明 和 访问 权限 。AndroidManifest.xml 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"introduction.android.mydbDemo" 
android:versionCode-"1" 
android:versionName-"1.0"» 
<uses-sdk android:minSdkVersion-"14" /> 
<uses-permission android:name="introduction.android.permission.USE_MYDB"/> 
<application 
android: icon="@drawable/ic_ launcher" 
android: label="@string/app_name"> 
<provider android:name-"MyDbProvider" 
android: authorities="introduction.android.mydbdemo.myfriendsdb" /> 


<activity 
android: label="@string/app_name” 
android:name=".MyDbDemoActivity"> 
<intent-filter> 
<action android:name-"android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 


</manifest> 
该 文件 通过 如 下 代码 : 


<provider android:name-"MyDbProvider" 
android:authorities="introduction.android.mydbdemo.myfriendsdb" /> 


指明 该 ContentProvider 名 为 MyDbProvider， 该 ContentProvider 的 Authority 为 introduction.android. 
mydbdemo.myfriendsdb。 

通过 如 下 代码 : 

<uses-permission android:name="introduction.android.permission.USE MYDB"/> 


指明 该 ContentProvider 的 权限 为 introduction.android.permission.USE MYDB, 只 有 具有 该 权限 的 应 
用 程序 才 可 以 访问 该 ContentProvider。 


7.4.55 ”访问 自 定义 ContentProvider 


本 小 节 讲解 如 何 通 过 ContentProvider 访问 其 他 应 用 程序 中 的 数据 ， 并 对 数据 进行 更 改 。 实 例 
UseDbProvider 演示 了 通过 7.4.4 小 节 建 立 的 自 定义 ContentProvider MyDbProvider 访问 实例 
MyDbDemo 中 建立 的 SQLite 数据 库 mydb， 并 对 其 中 的 数据 进行 CRUD 操作 的 过 程 。 实 例 
UseDbProvider 对 MyDbProvider 相关 信息 的 访问 是 从 MyFriendsDB 类 中 获取 的 。 

实例 UseDbProvider 的 运行 效果 如 图 7.6 所 示 。 该 视图 和 实例 MyDbDemo 一 样 ， 由 main.xml 
和 listxml 组 成 。 
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| usedbProvider 


wh 





图 7.6 UseDbProvider 界面 

该 实例 实现 的 步 又 如 下 : 

€D) 在 Eclipse 中 建立 工程 UseDbProvider, 定义 包 为 “introduction.android. useDbprovider" , 
定义 Activity 为 UseDbCPActivity。 

C€X302 从 工程 MyDbDemo 中 导出 MyDbProvider 的 信息 描述 类 MyFriendsDB。 具 体操 作 方 
法 如 下 : 

© 右 击 工程 MyDbDemo， 在 弹出 的 菜单 中 选择 Export 选项 ， 如 图 7.7 所 示 。 

o 在 弹出 的 对 话 框 中 选择 导出 类 型 为 Java | JAR file， 单 击 Next 按钮 ， 如 图 7.8 所 示 。 

















4 sS MyDbDemo :emove from Context 
4 (9 src Build Path 
4 [B introductioi Source Select an export destination: 
n pud SREES type filter text 
D Mypbp| 、 一 
Jj) MyDbp P3 Import. [.C JAR file| 
ae A Export. 5 Javadoc 
GB gen [Generate| References „D Runnable JAR file 
图 7.7 选择 Export 选项 图 7.8 选择 导出 类 型 


e 在 弹出 的 对 话 框 中 选择 导出 资源 为 MyFriendsDB.Java， 导 出 的 目标 文件 为 
“CAMyDbProvider.jar”, -4 Finish 按钮 。 这 样 ,就 把 MyFriendsDB 类 导出 到 myProviderjar 
文件 中 ， 也 就 可 以 导出 到 其 他 文件 中 使 用 了 ， 如 图 7.9 所 示 。 
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图 7.9 导出 过 程 


人 3 在 工程 MyFriendsDB 中 导入 MyFriendsDB. Ais UseDbProvider, 选择 Build Path | Add 
Extemal Archives 选项 (如 图 7.10 所 示 )， 在 弹出 的 对 话 框 中 选中 MyDbProvderjar， 即 可 将 
MyFriendsDB 类 导入 工程 中 。 


4 [jS UseDbPro © P 
(aima (X Delete 
4 [B intr © Remove from Context Ctrl Alt Shift+ Down 
Build Path > 
Source AlteShift+S >| 63 New Source Folder... 


Refactor AlteShift+T? | Use as Source Folder 


& assets ùy Import... fa Add External Archives... 
&bin | 24 Export. Add Libraries... 
D res 
idi Androic ¢ 





Refresh Configure Build Path... 


图 7.10 选择 Add External Archives 选项 


€I 编写 UseDbCPActivity 类 ， 通 过 ContentResolver 完成 对 MyDbProvider 的 访问 ， 进 而 
完成 对 数据 的 操作 。 


实例 UseDbProvider 中 UseDbCPActivity.java 的 代码 如 下 : 


package introduction.android.useDbprovider; 
import java.util.ArrayList; 

import java.util.HashMap; 

import java.util.List; 

import java.util.Map; 

import introduction.android.mydbDemo.MyFriendsDB; 
import android.app.Activity; 

import android.content.ContentUris; 

import android.content.ContentValues; 
import android.database.Cursor; 

import android.net.Uri; 
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import 
import 
import 
import 
import 
import 
import 
import 
import 
public 


android.os.Bundle; 

android. util.Log; 

android.view.View; 

android.widget .AdapterView; 

android.widget .Button; 

android.widget.EditText; 
android.widget.ListView; 
android.widget.SimpleAdapter; 
android.widget.AdapterView.OnItemClickListener; 
class UseDbCPActivity extends Activity ( 


private List<Map<String, String>>data; 
private SimpleAdapter listAdapter; 
private ListView listview; 
private HashMap<String, String>item; 
private Button selBtn, addBtn, updBtn, delBtn; 
private EditText et_name; 
private EditText et_age; 
private EditText et id; 
/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
et name- (EditText) findViewById (R.id.et name) ; 
et age- (EditText) findViewById (R.id.et age) ; 
et id- (EditText) findViewById (R.id.et id) ; 
listview- (ListView) findViewById (R.id.listView) ; 
selBtn- (Button) findViewById (R.id.bt query) ; 
addBtn- (Button) findViewById (R.id.bt add) ; 
updBtn- (Button) findViewById (R.id.bt modify) ; 
delBtn- (Button) findViewById (R.id.bt del) ; 
selBtn.setOnClickListener (new Button.OnClickListener () { 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
if (et id.getText().toString().equals ("")) 
dbFindAll (MyFriendsDB.CONTENT TYPE) ; 





else 
dbFindAll (MyFriendsDB.CONTENT ITEM TYPE) ;; 
} 
pz 
addBtn.setOnClickListener (new Button.OnClickListener() { 
@Override 


public void onClick (View v) { 
// TODO Auto-generated method stub 
dbAdd (null) ; 
dbFindAll (MyFriendsDB.CONTENT TYPE) ; 


pur 
updBtn.setOnClickListener (new Button.OnClickListener()(í 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
dbUpdate (null) ; 
dbFindAll (MyFriendsDB.CONTENT TYPE) ; 
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De 
delBtn.setOnClickListener (new Button.OnClickListener () { 
@override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
dbDel (-1) ; 
dbFindAll (MyFriendsDB.CONTENT TYPE) ; 


We 
data-new ArrayList<Map<String, String>>()# 
dbFindAll (MyFriendsDB.CONTENT TYPE) ; 
listview.setOnItemClickListener (new OnItemClickListener() { 
private String selld; 
@Override 
public void onItemClick (AdapterView<?>parent, View v, 
int position, long id) { 
// TODO Auto-generated method stub 
Map<String, Object>listItem= (Map<String, Object>) 
listview.getItemAtPosition (position) ; 
et_name.setText ((String) listItem.get ("name")) ; 
et age.setText ((String) listItem.get ("age")) ; 
et id.setText ((String) listItem.get (" id")) ; 
Log.i ("UseDB", "id="+selId) ; 


We 
} 
private void showList() { 
// TODO Auto-generated method stub 
listAdapter=new SimpleAdapter (this,data, 
R.layout.listview, 
new String[](" id","name","age"], 
new int[]{R.id.tvID,R.id.tvName,R.id.tvAge}) ; 
listview.setAdapter (listAdapter) ; 
) 
protected void dbDel (long iid) { 
// TODO Auto-generated method stub 
if (iid<0) ( 
String id-et id.getText().toString().trim(); 
if (id.equals ("")) | 
Log.e ("UseDB", "未 指定 更 新 数据 。") ; 
return; 
} 
iid-Long.parseLong (id) ; 
5 
Uri uri-ContentUris.withAppendedId (MyFriendsDB.CONTENT URI,iid) ; 
int i-this.getContentResolver().delete (uri, null, null) ; 
if (i>0) ( 
Log.i ("UseDB", "已 删除 数据 id="+iid) ; 
}else{ 


Log.i ("UseDB", "数据 未 删除 。"); 


protected void dbUpdate (ContentValues values) { 
// TODO Auto-generated method stub 
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String id-et id.getText().toString().trim(); 
if Gid.equals ("")) ( 
Log.e ("UseDB", "未 指定 更 新 数据 。") ; 
return; 
b 
Long selid-Long.parseLong (id) ; 
Uri uri-ContentUris.withAppendedId (MyFriendsDB.CONTENT URI,selid) ; 
if (values--null) ( 
values-new ContentValues(); 
values.put ("name", et name.getText().toString().trim()) ; 
values.put ("age", et age.getText().toString().trim()) ; 
p 
int i-this.getContentResolver().update (uri, values, null, null) ; 
if (i>0) { 
Log.i ("UseDB", "已 更 新 数据 id="+selid) ; 
Jelse( 


Log.e ("UseDB", "数据 更 新 失败 ! "2; 


Protected void dbadd (ContentValues values) { 


// TODO Auto-generated method stub 

ull) { 

value: ew ContentValues(); 

values.put ("name", et name.getText().toString().trim()) ; 
values.put ("age", et age.getText().toString().trim()) ; 


if (value 






) 
Uri uri-this.getContentResolver().insert (MyFriendsDB.CONTENT URI, values) ; 
if (uri--null) ( 

Log.e ("UseDB", "数据 插入 失败 ! ") ; 


n 
protected void dbFindAll (String type) { 
// TODO Auto-generated method stub 
data.clear(); 
Cursor cursor; 
Uri uri; 
if (typ: 
uri 
Jelse( 
Long selid-Long.parseLong (et id.getText().toString().trim()) ; 
uri-ContentUris.withAppendedId (MyFriendsDB.CONTENT URI,selid) ; 
Log.d ("UseDB",uri.toString()) ; 


MyFriendsDB.CONTENT TYPE) { 
lyFriendsDB.CONTENT_URI; 





} 
cursor=this.getContentResolver().query (uri, null, null, null, null) ; 
cursor.moveToFirst(); 
while (!cursor.isAfterLast()) ( 
String id-cursor.getString (0) ; 
String name-cursor.getString (1) ; 
String age-cursor.getString (2) ; 
item-new HashMap<String, String>(); 
item.put (" id", id) ; 
item.put ("name", name) ; 
item.put ("age", age) ; 
data.add (item) ; 
cursor.moveToNext () 7 
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$ 
showList(); 
H 
) 


由 于 工程 MyDbDemo 中 定义 了 MyDbProvider 的 访问 权限 ， 因 此 实例 UseDbProvider 的 
AndroidManifest.xml 文件 中 也 必须 声明 相应 权限 。AndroidManifest.xml 文件 的 代码 如 下 : 





<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"introduction.android.useDbprovider" 
android:versionCode-"1" 
android:versionName-"1.0"» 
«uses-sdk android:minSdkVersion-"14" /» 
<uses-permission android:name-"introduction.android.permission.USE MYDB"/» 
«application 
android:icon-"Gdrawable/ic launcher" 
android: label="@string/app_name"> 
<activity 
android: label="@string/app name" 
android:name-".UseDbCPActivity"» 
<intent-filter> 
<action android:name-"android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
</manifest> 


在 实例 UseDbProvider 中 对 SQLite 数据 库 mydb 进行 CRUD 操作 后 , 运行 MyDbDemo 进行 查 
询 ， 可 发 现 数据 库 中 的 数据 确实 被 改变 了 。 由 此 实现 了 在 一 个 应 用 程序 中 通过 自 定 义 的 
ContentProvider 修改 另 一 个 应 用 程序 中 的 持久 化 数据 的 功能 。 


7.5 数据 同步 到 云端 


7.5.1 App Engine 简介 


通过 提供 强大 的 Internet 连接 API, Android 框架 可 以 帮助 开发 者 创建 云端 应 用 程序 ， 使 用 户 
将 数据 同步 到 远 端的 Web 服务 器 上 ， 确 保 用 户 设 备 中 的 数据 总 是 与 服务 器 上 的 数据 同步 ， 并 且 用 
户 的 重要 数据 总 是 在 云端 服务 器 上 拥有 备份 。 

本 小 节 将 讲解 如 何 将 用 户 数据 同步 到 Google App Engine 的 过 程 。Google App Engine 是 一 个 
发 、 托 管 网 络 应 用 程序 的 平台 ， 基 于 云 计算 技术 开发 ， 使 用 Google 管理 的 数据 中 心 。 

通过 使 用 Google App Engine， 开 发 者 可 以 在 Google 基础 架构 上 运行 网 络 应 用 程序 。App 
Engine 应 用 程序 易于 构建 和 维护 ， 并 且 可 随 着 通信 和 量 和 数据 存储 需求 的 增长 而 轻松 扩展 。 在 使 用 
Google App Engine 时 ， 不 需要 维护 任何 服务 器 ， 只 需 上 传 应 用 程序 ， 它 便 可 以 为 用 户 提供 服务 。 

开发 者 可 以 使 用 Google Apps 通过 自己 的 域名 (如 http://www.example.com/) 提供 应 用 程序 。 
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或 者 使 用 appspot.com 域 中 的 免费 名 称 提供 应 用 程序 。 开 发 者 可 以 与 世界 各 地 的 用 户 共 享 应 用 程 
序 ， 也 可 以 设置 访问 权限 ， 仅 限 某 个 单位 的 成 员 能 够 访问 应 用 程序 。 

Google App Engine 支持 使 用 几 种 编程 语言 编写 的 应 用 程序 。 通 过 使 用 App Engine 的 Java 
RunTime 环境 , 开发 者 可 以 使 用 标准 Java 技术 构建 应 用 程序 , 包括 JVM, Java Servlet 和 Java 编 
程 语言 或 任何 其 他 基于 JVM 的 解释 器 或 编译 器 的 语言 (如 JavaScript 或 Ruby) 。App Engine 还 
提供 一 个 专用 的 Python 运行 时 环境 ， 其 中 包括 快速 Python 解释 器 和 Python 标准 库 。 建 立 的 
Java 和 Python 运行 时 环境 旨 在 确保 快速 安全 地 运行 应 用 程序 ， 而 不 会 受到 系统 上 其 他 应 用 程序 
Fit. 

在 初期 使 用 App Engine 时 , 开发 者 不 需要 支付 任何 费用 。App Engine 为 所 有 应 用 程序 提供 最 
多 500 MB 的 存储 空间 以 及 所 需 的 CPU 和 带宽 ， 以 保证 应 用 程序 的 正常 运行 。App Engine 为 每 个 
应 用 程序 免费 提供 每 月 约 500 万 页 的 浏览 量 。 在 为 应 用 程序 启用 计 费 时 ， 将 提高 应 用 程序 的 免费 
限制 ,开发 者 只 需 为 超过 免费 级 别 的 资源 付费 。 这 样 就 大 幅度 地 减少 了 应 用 程序 的 开发 成 本 ， 并 为 
应 用 程序 的 宣传 和 传播 搭建 了 平台 。 

可 惜 的 是 ，Google App Engine 在 中 国 大 陆地 区 被 禁止 访问 ， 目 前 大 陆 的 开发 者 不 能 通过 App 
Engine 发 布 自己 的 应 用 程序 ， 在 一 定 程 度 上 限制 了 国内 开源 软件 的 发 展 。 本 小 节 只 能 讲述 将 数据 
同步 到 App Engine 的 过 程 ， 实 际 的 操作 过 程 要 由 读者 自己 实践 。 





7.52 ”创建 可 相互 通信 的 Android 和 App Engine 应 用 程序 


编写 将 数据 同步 到 云端 的 应 用 程序 是 很 难 的 事情 ， 需 要 确保 很 多 的 细节 工作 正确 ， 例 如 服务 
器 端 授 权 、 客 户 端 授权 、 共 享 的 数据 模型 和 API 等 。 幸 运 的 是 ， 开 发 者 不 需要 自己 来 完成 每 一 件 
事 ， 借 助 于 GPE (Google Plugin for Eclipse) 可 以 大 大 简化 开发 的 过 程 。GPE 用 于 管理 Android it 
备 与 Google App Engine 间 对 话 的 管道 。 

1. 准备 环境 

安装 GPE 和 GWT SDK. M https://developers.google.conveclipse/docs/install-from-zip?hl-zh-CN 
页 面 可 以 获得 安装 GPE 的 帮助 。 由 于 笔者 使 用 的 Eclipse WAX A Indigo, Bl 3.7 版 本 ， 因 此 笔者 从 
http://dl.google.com/eclipse/plugin/core/3.7/zips/gpe-e37-latest-updatesite.zip 下 载 了 GPE 3.7 版 本 ， 该 
版 本 中 包含 GWT SDK 2.4 版 本 。 安 装 GPE 的 方法 很 简单 ， 单 击 Eclipse 界面 的 Help | install new 
software | add | Archive 命令 ,在 弹出 的 对 话 框 中 选择 下 载 的 gpe-e37-latest-updatesite.zip 文件 ， 单 击 
OK 按钮 ， 如 图 7.11 所 示 。 在 弹出 的 对 话 框 中 选择 要 安装 的 组 件 ， 并 进行 安装 ， 如 图 7.12 所 示 。 











(8) Add Repository 
Name: GPE3.7.0 Local... 


Location: jarfle/D:/ FR/Android tools/com.google.gdt.eclip: 








9 (oe) cre ] 





7.11 安装 GPE 3.7 
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lame Version 
[V] 000 Google App Engine Tools for Android (requires ADT) 
V| 4» Google App Engine Tools for Android 3.0.1.v201206290132-rel-r37 
V] 000 Google Plugin for Eclipse (required) 
V) 4» Google Plugin for Eclipse 3.7 3.0.1..201206290132-rel-r37 
W] 000 GWT Designer for GPE (recommended) 
[7] 000 SDKs 
[V] 4» Google Web Toolkit SDK 2.4.0 2.4.0..201206290132-rel-r37 














图 7.12 安装 GPE 组 件 


安装 Java App Engine SDK. MM _https://developers.google.com/appengine/downloads?hl=zh- 
CN#Google App Engine SDK for Java 页面 下 载 Google App Engine SDK for Java， 笔 者 下 载 的 是 
1.7.0 版 本 。 解 压 到 硬盘 后 ,在 Eclipse | Windows | Preferences | Google | App Engine | add 界面 添加 解 
压 目录 ，Eclipse 会 检测 到 App Engine SDK 并 完成 安装 。 

注册 一 个 Google 账号 ,以 便于 C2DM (Android Cloud to Device Messaging) 功能 访问 。C2DM 
是 Android 云 到 设备 信息 的 传递 框架 ， 用 于 从 云端 发 送 少量 数据 到 Android 客户 端 设备 。 要 获取 服 
务 器 上 不 定时 更 新 的 信息 ， 一 般 有 两 种 方法 ， 第 一 种 是 客户 端 使 用 拉 〈Pull) 的 方式 ， 隔 一 段 时 间 
就 去 服务 器 上 获取 信息 ， 看 是 否 有 更 新 的 信息 出 现 ， 第 二 种 是 服务 器 使 用 推送 (Push) 的 方式 ， 当 
服务 器 端 有 新 信息 时 ， 把 最 新 的 信息 推送 到 客户 端 上 。 相 比 之 下 ,推送 方法 更 好 一 些 , 不 仅 可 以 节 
省 客户 端的 网 络 流量 ， 更 能 够 节省 电量 。Android 从 2.2 版 本 开始 增加 了 C2DM 框架 ， 用 于 将 服务 
器 的 信息 推送 到 客户 端 。 

2. 创建 工程 


当 安 装 好 GPE Jai, Eclipse 会 出 现 App Engine Connected Android Project 工程 类 型 。 工 程 创建 
向 导 会 提示 输入 C2DM 账户 信息 ， 这 个 账户 就 是 在 上 面 注册 的 新 账户 。 

工程 创建 完成 后 ， 会 出 现 两 个 项 目 ， 一 个 是 Android 应 用 程序 ， 另 一 个 是 App Engine 应 用 程 
序 。 工 程 向 导 在 这 两 个 项 目 中 创建 了 示例 代码 ， 允 许 用 户 通过 AccountManager 来 验证 Android 设 
备 与 App Engine 之 间 的 交互 。 

右 击 Android 项 目 ， 选 择 Debug As | Local App Engine Connected Android Application。 这 样 就 
能 够 测试 C2DM 的 功能 ， 同 时 启动 一 个 App Engine 的 本 地 实例 对 象 ， 里 面包 含 用 户 的 程序 。 

3. 创建 数据 层 

上 一 步 创 建 了 能 够 在 Android 设备 与 App Engine 间 进 行 交互 的 工程 ， 下 面 修改 相关 代码 实现 
自己 的 功能 。 

首先 创建 数据 层 ， 它 定义 Android 设备 与 App Engine 之 间 共 享 的 数据 。 打 开 App Engine 项 目 
的 文件 夹 ， 定 位 到 (yourApp)-AppEngine | src | (yourapp) | server。 创 建 一 个 新 的 类 ， 该 类 包含 需 
要 存储 到 云端 的 数据 。 示 例 代 码 如 下 : 


package com.cloudtasks.server; 


import javax.persistence.*; 


@Entity 
public class Task { 
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private String emailAddress; 
private String name; 
private String userId; 
private String note; 


@Id 
@GeneratedValue (strategy=GenerationType. IDENTITY) 
private Long id; 


public Task(){ 
} 


public String getEmailAddress() { 
return this.emailAddress; 


} 


public Long getId() { 
return this.id; 
} 
m 
代码 中 的 @Entity、@ Id 与 @GeneratedValue 都 来 自 Java 持久 化 API， 这 些 注释 都 是 必需 的 。 
@Entity 需要 被 注释 在 类 声明 的 上 面 ， 表 明 这 个 类 是 被 定义 在 数据 层 的 一 个 实体 。@Id 与 
@GeneratedValue 分 别 表明 了 实体 类 的 id 与 该 id 形成 的 规则 。 在 上 面 的 代码 中 ，GenerationType. 
IDENTITY 表示 该 实体 的 id 是 从 数据 库 中 生成 的 。 
完成 实体 数据 类 的 创建 后 ， 需 要 创建 Android 与 App Engine 程序 之 间 交 互 的 方法 。 这 种 交互 
的 方法 是 通过 创建 一 个 Remote Procedure Call (RPC) 服务 完成 的 。 具 体 实 现 的 过 程 相对 复杂 ， 但 
是 GPE 提供 了 简单 的 实现 方式 。 右 击 App Engine 项 目的 源码 文件 来， 选择 New | Other， 再 选择 
Google | RPC Service， 会 出 现 向 导 ， 罗 列 出 所 有 已 创建 的 实体 类 ， 单 击 Finish 按钮 ， 向 导 会 创建 一 
个 Service 类 ， 它 包含 对 所 有 实体 类 的 创建 、 查 询 、 更 新 和 删除 (CRUD) 操作 。 
4. 创建 持久 层 


持久 层 是 用 于 长 期 存放 应 用 程序 数据 的 地 方 。 根 据 要 存储 的 数据 类 型 ， 开 发 者 有 几 种 可 选择 
的 实现 方法 ， 其 中 由 Google 管理 的 可 实现 持久 层 的 方法 为 Google Storage for Developers 和 App 
Engine 的 内 建 DataStore。 下 面 是 一 个 使 用 DataStore 实现 持久 层 的 示例 。 

在 com.cloudtasks.server 包 下 创建 一 个 类 用 来 处 理 持久 层 的 输入 与 输出 。 为 了 访问 这 些 数 据 ， 
需要 使 用 PersistenceManager 类 。 可 以 使 用 在 com.google.android.c2dm.server.PMF 包 下 的 PMF XÆ 
成 这 个 类 的 一 个 实例 ， 然 后 使 用 该 实例 来 执行 基本 的 CRUD 操作 : 

ys 

* Remove this object from the data store. 

Myr 

public void delete (Long id) ( 

PersistenceManager pm-PMF.get ().getPersistenceManager(); 
try { 


Task item-pm.getObjectById (Task.class, id) ; 
pm.deletePersistent (item) ; 
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} finally { 
pm.close() 7 
} 
} 


此 外 ， 也 可 以 使 用 Query 对 象 从 Datastore 来 检索 数据 。 


public Task find (Long id) { 
if (id--null) { 
return null; 


} 


PersistenceManager pm-PMF.get().getPersistenceManager(); 

try { 
Query query-pm.newQuery ("select from "4Task.class.getName () 
+" where id=="+id.toString()+" && emailAddress=='"+getUserEmail()+"'") ; 
List list- (List) query.execute(); 
return list.size()--0 ? null : list.get (0) ; 

) catch (RuntimeException e) { 
System.out.println (e) ; 
throw e; 

) finally ( 
pm.close(); 

) 

) 


5. 从 Android 应 用 程序 进行 查询 和 更 新 

为 保证 Android 设备 与 App Engine 的 同步 ，Android 端 应 用 程序 需要 完成 两 件 事情 : 从 云端 拉 
取 数 据 和 向 云端 发 送 数据 。 这 些 功能 已 经 由 示例 代码 生成 了 ， 开 发 者 需要 进行 修改 以 完成 自己 的 功能 。 

首先 ， 需 要 将 示例 代码 中 的 Activityjava 中 的 setHelloWorldScreenContent( 方 法 删除 ， 用 实际 
的 功能 代码 替换 ; 然后， 交互 操作 应 该 在 AsyncTask 类 中 完成 ， 以 避免 网 络 操作 导致 UI 线程 卡 住 ; 
最 后 ， 访 问 云端 数据 ， 使 用 RequestFactory 来 进行 操作 ， 该 类 由 Eclipse plugin 提供 。 

如 果 云 端 数据 模型 包含 一 个 叫 作 Task 的 对 象 ， 那 么 这 个 对 象 会 在 生成 RPC layer 的 时 候 自动 
创建 一 个 TaskRequest 类 对 象 ， 以 及 一 个 代表 单独 的 Task 的 TaskProxy 对 象 。 下 面 的 代码 演示 了 向 
服务 器 请 求 所 有 task 的 列表 的 功能 。 


public void fetchTasks (Long id) { 
// Request is wrapped in an AsyncTask to avoid making a network request 
// on the UI thread. 
new AsyncTask() { 
GOverride 
protected List doInBackground (Long... arguments) ( 
final List list-new ArrayList(); 
MyRequestFactory factory-Util.getRequestFactory (mContext, 
MyRequestFactory.class) ; 
TaskRequest taskRequest-factory.taskNinjaRequest (); 


if (arguments.length--0 || arguments[0]==-1) ( 
factory.taskRequest () .queryTasks () .fire (new Receiver<list>() { 
GOverride 
public void onSuccess (List arg0) { 
list.addAll (arg0) ; 


AsyncTask 类 返回 了 一 个 TaskProxy 对 象 的 列表 , 并 且 将 该 列表 作为 参数 发 送 给 了 dump 方法 。 

为 了 创建 一 个 新 的 任务 并 发 送 到 云端 ， 需 要 创建 一 个 新 的 请 求 对 象 并 使 用 它 来 创建 一 个 proxy 
对 象 。 然 后 通过 proxy 对 象 执行 它 的 更 新 方法 。 这 个 过 程 应 该 在 AsyncTask 中 执行 ， 以 避免 阻塞 
UI 线 程 。 相 关 代码 如 下 : 
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6. 配置 C2DM 服务 器 端 


为 了 配置 C2DM 的 消息 以 便 能 被 发 送 到 Android 设备 ， 我 们 回 到 App Engine 的 代码 处 并 打 
生成 RPC 层 时 创建 的 Service 类 。 如 果 项 目 名 是 Foo, 该 Service 类 的 名 字 就 叫 FooService。 为 Service 
每 一 个 方法 都 添加 代码 ， 人 允许 执行 增加 、 删 除 和 更 新 数据 的 操作 ， 这 样 C2DM 消息 才能 被 发 送 到 
用 户 的 设备 上 。 对 数据 进行 更 新 的 相关 示例 代码 如 下 : 

public static Task updateTask (Task task) { 

task.setEmailAddress (DataStore.getUserEmail()) ; 
task=db.update (task) ; 


DataStore.sendC2DMUpdate (TaskChange.UPDATE+TaskChange.SEPARATOR+task.getId()) ; 
return task; 

















// Helper method. Given a String, send it to the current user's device via C2DM. 
public static void sendC2DMUpdate (String message) { 
UserService userService-UserServiceFactory.getUserService(); 
User user-userService.getCurrentUser(); 
ServletContext 
context-RequestFactoryServlet.getThreadLocalRequest () .getSession() .getServletContext (); 
SendMessage.sendMessage (context, user.getEmail(), message) ; 


} 


下 面 的 示例 代码 中 创建 了 一 个 帮助 类 TaskChange。 该 类 中 创建 了 一 些 常 量 ， 能 够 使 得 App 
Engine 与 Android 应 用 程序 之 间 的 交互 更 加 简单 。 帮 助 类 应 该 被 创建 在 共享 文件 夹 中 。 


public class TaskChange { 
public static String UPDATE="Update"; 
public static String DELETE="Delete"; 
public static String SEPARATOR-":"; 

) 


7. 配置 C2DM 客户 端 


为 了 定义 当 Android 应 用 程序 接收 到 C2DM 的 消息 时 的 行为 ， 我 们 打开 C2DMReceiver 类 ， 
找到 onMessage0 方 法 并 根据 接收 到 的 消息 类 型 修改 这 个 方法 。 


//In your C2DMReceiver class 





public void notifyListener (Intent intent) { 
if (listener !=null) { 
Bundle extras-intent.getExtras(); 
if (extras !-null) { 
String message- (String) extras.get ("message") ; 
String[] messages-message.split (Pattern.quote (TaskChange.SEPARATOR)) ; 
listener.onTaskUpdated (messages[0], Long.parseLong (messages[1])) ; 


) 
//Elsewhere in your code, wherever it makes sense to perform local updates 
public void onTasksUpdated (String messageType, Long id) ( 
if (messageType.equals (TaskChange.DELETE)) { 
// Delete this task from your local data store 


) else { 





// Call that monstrous Asynctask defined earlier. 
fetchTasks (id) ; 


) 
至 此 ，C2DM 消息 触发 了 本 地 Android 设备 中 信息 的 更 新 ， 同 步 到 云端 操作 完成 。 


76 数据 备份 与 恢复 


7.6.1 Android 数据 备份 与 恢复 简介 


Android 的 备份 服务 允许 用 户 将 应 用 程序 的 持久 化 数据 复制 到 远 端 云 存储 ， 以 便 为 应 用 程序 的 
数据 和 设置 信息 创建 一 个 还 原点 。 如 果 用 户 为 设备 恢复 了 出 厂 设置 或 者 更 换 了 新 的 Android 设备 ， 
当 安 装 应 用 程序 时 ,系统 会 自动 恢复 用 户 备份 的 数据 到 应 用 程序 。 这 样 用 户 就 不 需要 人 为 复制 之 前 
的 数据 和 配置 信息 。 该 过 程 对 用 户 完全 透明 ， 不 会 影响 应 用 程序 的 功能 和 用 户 体验 。 

当 应 用 程序 发 起 备份 请 求 时 , Android 的 备份 管理 器 BackupManager 会 查询 需要 备份 的 应 用 程 
序数 据 ， 并 将 其 交 给 备份 传输 器 ， 再 由 备份 传输 器 将 数据 传输 到 云 存 储 保存 起 来 。 当 执行 恢复 操作 
时 ,备份 管理 器 从 备份 传输 器 获取 备份 数据 并 交还 给 应 用 程序 , 由 应 用 程序 将 备份 数据 恢复 到 设备 。 
恢复 操作 请 求 可 以 由 应 用 程序 发 起 , 但 并 不 是 必需 的 。 如 果 应 用 程序 被 安装 并 且 存 在 与 用 户 关联 的 
备份 数据 ， 当 用 户 重 置 手机 的 所 有 配置 或 者 升级 到 新 的 设备 时 ，Android 系统 都 会 自动 执行 数据 恢 
复 操作 。 

需要 注意 的 是 ， 备 份 服务 并 不 是 为 了 与 其 他 设备 同步 数据 或 者 在 应 用 程序 的 正常 生命 周期 中 
保存 数据 而 设计 的 。 备 份 的 数据 不 能 被 随意 访问 和 改写 ， 必 须要 使 用 备份 管理 器 提供 的 API 进行 
访问 。 

备份 传输 器 是 Android 数据 备份 框架 的 客户 端 组 件 ， 由 设备 制造 商 和 服务 提供 商 共同 定制 。 备 
份 传输 器 可 能 因 设 备 的 不 同 而 不 同 , 并 且 对 设备 而 言 是 透明 的 。 备份 管理 器 将 应 用 程序 和 备份 传输 
器 分 离开 来 ， 应 用 程序 通过 固定 的 API 与 备份 管理 器 进行 通信 ， 而 不 考虑 底层 传输 的 具体 实现 过 程 。 

数据 备份 功能 并 不 保证 在 所 有 的 Android 设备 上 都 支持 。 但 是 ， 即 使 设备 不 支持 数据 备份 ， 应 
用 程序 也 会 正常 运行 ， 只 是 不 能 接收 备份 管理 器 的 备份 请 求 对 数据 进行 备份 而 已。 

备份 的 数据 不 会 被 设备 上 的 其 他 应 用 程序 访问 ， 只 有 备份 管理 器 和 备份 传输 器 有 权限 访问 备 
份 的 数据 。 另外， 由 于 云 存 储 数据 传输 服务 因 设备 的 不 同 而 不 同 ， 因 此 Android 系统 不 能 保证 备份 
数据 的 安全 性 。 所 以 当 用 户 使 用 云 存 储备 份 敏感 数据 时 例如 用 户 名 和 密码 ) ， 应 三 思 而 行 。 








7.6.2 ”实现 备份 代理 的 步骤 


为 了 备份 应 用 程序 数据 ， 需 要 使 用 备份 代理 。 备 份 代理 将 被 备份 管理 器 调用 ， 用 于 提供 所 需 
备份 的 数据 。 当 应 用 程序 被 重新 安装 时 ， 备 份 管理 器 还 要 调用 此 备份 代理 来 恢复 应 用 程序 的 数据 。 
备份 管理 器 通过 备份 传输 器 处 理 所 有 Android 设备 与 云 存储 之 间 的 数据 传输 工作 , 而 备份 代理 则 负 
责 所 有 对 设备 上 数据 的 处 理 。 
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实现 备份 代理 需要 经 过 以 下 步骤 : 
€) f£ manifest 文件 中 用 android:backupAgent 属 性 声明 备份 代理 。 相 关 代码 如 下 : 
«manifest ...> 


«application android:label-"MyApplication" 
android: backupAgent="MyBackupAgent"> 
<activity ...> 
</activity> 
</application> 
</manifest> 


以 上 代码 为 应 用 程序 声明 了 一 个 名 为 MyBackupAgent 的 备份 代理 。 
人 0 A Android 备份 服务 进行 注册 。 


Google 为 Android 2.2 以 上 版 本 的 设备 提供 了 利用 Android 备份 服务 进行 备份 传输 的 服务 。 应 
用 程序 要 利用 Android 备份 服务 执行 备份 操作 ， 必 须 对 应 用 程序 进行 注册 以 获得 一 个 备份 服务 的 
Backup Service Key， 然 后 在 Android manifest 文件 中 声明 这 个 Key。 

要 获取 Backup Service Key， 需 要 到 https://developers.google.com/android/backup/signup? 
hl=zh-CN 为 Android 服务 进行 注册 。 注 册 时 会 得 到 一 个 Backup Service Key 和 Android manifest 文 
件 内 相应 的 <meta-data>XML 代码 ， 这 段 代码 必须 包含 在 <application> 元 素 下 。 相 关 示 例 代码 如 下 : 

<application android: label="MyApplication" 


android: backupAgent="MyBackupAgent"> 


aes android:name-"com.google.android.backup.api key" 
android:value-"AEdPqrEAAAAIDaYEVgUGDUnyJdBmU7KLH3kszDXLv 4DISEIyQ" /> 
</application> 
android:name 必须 是 com.google.android.backup.api key, android:value 也 必须 是 注册 Android 
备份 服务 时 获得 的 Backup Service Key。 
如 果 存 在 多 个 应 用 程序 ， 就 需要 根据 每 个 程序 的 package name 分 别 为 每 一 个 应 用 程序 进行 注册 。 
EI 实现 备份 代理 。 


实现 备份 代理 有 两 种 方式 ， 分 别 为 : 

e 继承 BackupAgent, BackupAgent 类 提供 了 核心 接口 , 应 用 程序 通过 这 些 接口 与 备份 管理 器 进 
行 通信 。 若 直接 继承 此 类 ， 则 必须 覆盖 onBackup0 和 onRestore() 方 法 来 处 理 数据 的 备份 和 恢 
复 操作 。 

e 继承 BackupAgentHelper。BackupAgentHelper 类 提供 了 BackupAgent 类 的 易 用 性 封装 ， 大 幅 
度 减少 了 需 编写 的 代码 数量 。 在 BackupAgentHelper 内 ， 必 须 用 一 个 或 多 个 helper 对 象 来 自 
动 备份 和 恢复 特定 类 型 的 数据 ， 因 此 不 再 需要 实现 onBackup0 和 onRestore() 2: ik T . 


Android 目前 提供 两 种 backup helper， 分 别 用 于 SharedPreferences 和 内 部 存储 的 备份 和 恢复 操作 。 





7.6.3 通过 BackupAgent 实现 备份 与 恢复 


大 多 数 应 用 程序 不 需要 直接 继承 BackupAgent 类 ， 而 是 继承 BackupAgentHelper 类 ， 并 利用 
BackupAgentHelper 内 建 的 helper 类 自动 备份 和 恢复 文件 。 不 过 ， 以 下 三 种 情况 需要 直接 继承 
BackupAgent 类 来 实现 备份 代理 : 


© ”将 数据 格式 版 本 化 。 例 如 ， 需 要 在 恢复 数据 时 修正 格式 ， 可 以 建立 一 个 备份 代理 ， 在 数据 恢 
复 过 程 中 ， 如 果 发 现 当前 版 本 和 备份 时 的 版 本 不 一 致 ， 可 以 执行 必要 的 兼容 性 修正 工作 。 

e 不 是 备份 整个 文件 ， 而 是 指定 备份 部 分 数据 以 及 恢复 部 分 数据 到 设备 。 

© 备份 数据 库 中 的 数据 。 若 应 用 程序 使 用 了 SQLite 数据 库 并 且 希 望 当 用 户 重 装 应 用 程序 时 能 够 
恢复 数据 库 中 的 数据 ， 则 需要 建立 一 个 自 定义 的 BackupAgent。 它 在 备份 操作 时 从 数据 库 中 
读 取 合适 的 数据 ， 在 恢复 数据 操作 时 建立 数据 表 并 插入 数据 。 

通过 继承 BackupAgent 类 创建 备份 代理 时 ， 必 须 实现 以 下 两 个 方法 : 

* onBackup(0。 备 份 管理 器 在 程序 请 求 进行 备份 操作 后 将 调用 该 方法 。 在 该 方法 中 实现 从 设备 
读 取 应 用 程序 数据 ， 并 把 需 备 份 的 数据 传递 给 备份 管理 器 的 操作 。 

* onRestore0。 备 份 管理 器 在 恢复 数据 时 调用 该 方法 。 备 份 管理 器 调用 该 方法 时 将 传 入 备份 的 
数据 ， 并 通过 该 方法 将 数据 恢复 到 设备 上 。 

1. 备份 数据 

应 用 程序 发 出 数据 备份 请 求 时 ， 备 份 管理 器 将 调用 onBackup0 方 法 。 在 此 方法 内 必须 把 要 备 

份 的 数据 提供 给 备份 管理 器 ， 然 后 将 数据 保存 到 云 存储 中 。 
只 有 备份 管理 器 能 够 调用 备份 代理 中 的 onBackup( 方 法 。 当 数据 发 生 改变 并 需要 执行 备份 时 ， 
需要 调用 dataChanged() 方 法 发 起 备份 请 求 。 备 份 请 求 并 不 会 立即 导致 onBackup0 方 法 的 调用 ， 备 
份 服务 器 会 等 待 合适 的 时 机 ， 为 上 次 备份 操作 后 又 发 出 备份 请 求 的 所 有 应 用 程序 执行 备份 操作 。 
onBackup0 方 法 需要 传 入 三 个 参数 ， 所 代表 的 意义 分 别 如 下 。 

* oldState: 表示 已 打开 的 、 只 读 的 文件 描述 符 ParcelFileDescriptor， 指 向 应 用 程序 提供 的 上 次 
备份 数据 状态 的 文件 。 该 文件 不 是 来 自 云 存储 的 备份 数据 ， 而 是 记录 上 次 调用 onBackup0 备 
份 数据 相关 状态 信息 的 本 地 文件 。onBackup() 方 法 不 能 读 取保 存 于 云 存 储 的 数据 ， 可 以 根据 
此 信息 来 判断 数据 自 上 次 备份 以 来 是 否 变动 过 。 

* Data: BackupDataOutput 对 象 ， 用 于 将 要 备份 的 数据 传 给 备份 管理 器 。 

* newState: 表示 已 打开 的 、 可 读 写 的 文件 描述 符 ParcelFileDescriptor， 指 向 一 个 用 于 将 提交 给 
data 参数 的 数据 相关 状态 信息 写 入 的 文件 ， 状 态 信息 可 以 简单 到 只 是 文件 的 最 后 修改 时 间 。 
备份 管理 器 下 次 调用 onBackup0 〇 时 ,该 对 象 作 为 oldState 传 入 。 若 没有 向 newState 写 入 信息 ， 
则 备份 管理 器 下 次 调用 onBackupO 时 oldState 将 指向 一 个 空 文件 。 





利用 以 上 参数 可 以 实现 onBackup0， 方 法 如 下 : 

C270) 通过 比较 oldState， 检 查 自 上 次 备份 以 来 数据 是 否 发 生 过 改变 。 从 oldState 读 取 信息 
的 方式 取决 于 当时 写 入 的 方式 ( 见 步骤 3) 。 最 简单 的 记录 文件 状态 的 方式 是 写 入 文件 的 最 后 修改 时 
Tei, WAT EM oldState 读 取 并 比较 时 间 戳 的 代码 : 
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// Get the oldState input stream 
FileInputStream instream-new FileInputStream (oldState.getFileDescriptor()) ; 
DataInputStream in-new DataInputStream (instream) ; 
try { 
// Get the last modified timestamp from the state file and data file 
long stateModified-in.readLong(); 
long fileModified-mDataFile.lastModified(); 
if (stateModified !=fileModified) ( 
// The file has been modified, so do a backup 
// Or the time on the device changed, so be safe and do a backup 
} else { 
// Don't back up because the file hasn't changed 
return; 
} 
} catch (IOException e) { 
// Unable to read state file... be safe and do a backup 
) 
如 果 数 据 没 有 发 生变 化 ， 就 不 需要 进行 备份 ， 请 跳 转 到 步骤 3。 
Eo 在 和 oldState 比较 后 ， 如 果 数据 发 生 了 变化 ,就 把 当前 数据 写 入 data 以 便 将 其 返回 并 
上 传 到 云 存储 中 。 


必须 以 BackupDataOutput 中 的 “entity“ 方 式 写 入 每 一 块 数据 。 一 个 entity 是 一 个 二 进 制 数 据 


记录 ， 使 用 一 个 唯一 的 字符 串 键 值 进行 标识 。 因 此 ， 所 备份 的 数据 集 实际 上 是 一 组 键 值 对 。 要 在 备 
份 数据 集中 增加 一 个 entity， 必 须 : 


数 ， 


(1) 调用 writeEntityHeader0 方 法 ， 传 入 代表 要 写 入 数据 的 唯一 字符 串 键 值 和 数据 大 小 。 

(2) 调用 writeEntityData0 方 法 ， 传 入 存放 着 数据 的 字 节 缓 冲 区 ， 以 及 需 从 缓冲 区 写 入 的 字 节 
该 字 节 数 应 该 与 传 给 writeEntityHeader0 的 数据 大 小 一 致 。 

下 面 的 示例 代码 演示 了 把 一 些 数据 拼接 为 字 节 流 并 写 入 一 个 entity 的 过 程 : 


// Create buffer stream and data output stream for our data 
ByteArrayOutputStream bufStream-new ByteArrayOutputStream(); 
DataOutputStream outWriter-new DataOutputStream (bufStream) ; 
// Write structured data 

outWriter.writeUTF (mPlayerName) ; 

outWriter.writeInt (mPlayerScore) ; 

// Send the data to the Backup Manager via the BackupDataOutput 
byte[] buffer=bufStream.toByteArray () 7 

int len=buffer. length; 

data.writeEntityHeader (TOPSCORE_BACKUP_KEY, len) ; 
data.writeEntityData (buffer, len) ; 


需要 备份 的 每 一 块 数据 都 要 执行 一 次 该 操作 。 如 何 将 数据 切 分 为 entity 由 开发 者 决定 。 
C23 无 论 是 否 执行 了 数据 备份 (步骤 2)， 都 要 把 当前 数据 的 状态 信息 写 入 newState 














ParcelFileDescriptor 指向 的 文件 内 。 备 份 管理 器 会 在 本 地 保持 此 对 象 ， 以 代表 当前 备份 数据 。 下 次 调 
用 onBackup0 时 ， 此 对 象 作 为 oldState 返回 给 应 用 程序 ， 由 此 可 以 决定 是 否 需要 再 做 一 次 备份 (如 
步骤 1 所 述 ) 。 如 果 不 把 当前 数据 的 状态 写 入 此 文件 ， 下 次 调用 时 oldState 将 返回 空 值 。 
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以 下 示例 代码 把 文件 的 最 后 修改 时 间 戳 作为 当前 数据 的 状态 存 入 newState: 
FileOutputStream outstream=new FileOutputStream (newState.getFileDescriptor() ) B 
DataOutputStream out-new DataOutputStream (outstream) ; 
long modified-mDataFile.lastModified(); 
out.writeLong (modified) ; 
需要 注意 的 是 ， 如 果 应 用 程序 数据 存放 于 文件 中 ， 需 要 使 用 同步 语句 (synchronized) 来 访问 
文件 。 这 样 在 应 用 程序 的 Activity 进行 写 文件 操作 时 ， 备 份 代理 就 不 会 去 读 文 件 了 。 
2. 执行 数据 恢复 操作 
恢复 程序 数据 时 ， 备 份 管理 器 将 调用 备份 代理 的 onRestore() 方 法 。 调 用 此 方法 时 ， 备 份 管理 
器 会 把 在 云 存储 备份 的 数据 传 入 ， 以 供 恢复 到 设备 中 去 。 
只 有 备份 服务 器 能 够 调用 onRestore( 方 法 ， 在 系统 安装 应 用 程序 并 且 发 现 有 备份 数据 存在 时 ， 
数据 恢复 操作 会 自动 发 生 。 此 外 , 应 用 程序 也 可 以 通过 调用 requestRestore() 方 法 来 发 起 恢复 数据 的 
请 求 。 
当 备 份 管理 器 调用 onRestore() 方 法 时 ， 传 入 以 下 三 个 参数 。 
* Data: BackupDatalnput 对 和 象 ， 用 以 读 取 备 份 数据 。 
* appVersionCode: 整 型 数据 ， 表 示 备 份 数 据 时 ， 应 用 程序 的 manifest 的 android: versionCode 
属性 。 可 以 用 于 核对 当前 应 用 程序 版 本 并 确定 数据 格式 的 兼容 性 。 
* newState; 已 打开 的 、 可 读 写 的 文件 描述 符 ParcelFileDescriptor， 指 向 一 个 文件 ， 用 于 写 入 最 
后 一 次 提交 data 数据 的 备份 状态 。 本 对 象 在 下 次 调用 onBackup0 方 法 时 作为 oldState 返回 。 


在 实现 onRestore0 时 ， 应 该 对 data 调用 readNextHeader0， 以 遍历 数据 集 里 所 有 的 entity。 对 
其 中 每 个 entity 需 进 行 以 下 操作 : 
(1) 用 getKey0 方 法 获取 entity 的 键 值 。 
(2) 将 此 entity 键 值 和 已 知 键 值 清单 进行 比较 ， 这 个 清单 应 该 已 经 在 BackupAgent 继承 类 中 
作为 字符 串 常量 定义 。 一 旦 键 值 匹 配 其 中 一 个 键 ， 就 执行 读 取 entity 数据 并 保存 到 设备 的 操作 : 


* 用 getDataSize0 读 取 entity 数据 大 小 并 据 其 创建 字 节 数组 。 
© 调用 readEntityData(), 传 入 字 节 数组 作为 获取 数据 的 缓冲 区 ， 并 指定 起 始 位 置 和 读 取 字 节 数 。 
e 字 节 数组 将 被 填 入 数据 ， 按 需 读 取 数 据 并 写 入 设备 即 可 。 


(3) 把 数据 读 出 并 写 回 设备 以 后 ， 把 数据 的 状态 写 入 newState 参数 。 
下 面 的 实例 代码 将 前 面 的 例子 中 所 备份 的 数据 进行 了 恢复 : 


@Override 
public void onRestore (BackupDataInput data, int appVersionCode, 
ParcelFileDescriptor newState) throws IOException { 
// There should be only one entity, but the safest 
// way to consume it is using a while loop 
while (data.readNextHeader()) { 
String key=data.getKey(); 
int dataSize-data.getDataSize(); 


























// 1f the key is ours (for saving top score) . Note this key was used when 
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// we wrote the backup entity header 
if (TOPSCORE_BACKUP_KEY.equals (key)) { 
// Create an input stream for the BackupDataInput 
byte[] dataBuf-new byte[dataSize]; 
data.readEntityData (dataBuf, 0, dataSize) ; 
ByteArrayInputStream baStream-new ByteArrayInputStream (dataBuf) ; 
DataInputStream in-new DataInputStream (baStream) ; 


// Read the player name and score from the backup data 
mPlayerName-in.readUTF(); 
mPlayerScore-in.readInt(); 


// Record the score on the device (to a file or something) 
recordScore (mPlayerName, mPlayerScore) ; 

} else { 
// We don't know this entity key. Skip it. (Shouldn't happen.) 
data.skipEntityData(); 


} 


// Finally, write to the state blob (newState) that describes the restored data 
FileOutputStream outstream-new FileOutputStream (newState.getFileDescriptor()) ; 
DataOutputStream out-new DataOutputStream (outstream) ; 

out.writeUTF (mPlayerName) ; 

out.writeInt (mPlayerScore) ; 


) 


在 以 上 代码 中 ， 传 给 onRestoreO 的 appVersionCode 参数 没有 被 用 到 。 如 果 用 户 程序 的 版 本 降 
低 ， 比 如 从 1.5 降 到 1.0， 可 能 就 会 用 此 参数 来 选择 备份 数据 。 


7.64 通过 BackupAgentHelper 实现 备份 与 恢复 


1. 实现 BackupAgentHelper 


如 果 要 备份 整个 SharedPreferences 和 内 部 存储 文件 , 就 应 该 使 用 BackupAgentHelper 的 子 类 创 
建 备份 代理 ， 这 种 方式 不 需要 实现 onBackup0 和 onRestore0 方 法 ， 因 此 可 以 比 使 用 BackupAgent 
实现 的 方式 大 幅度 地 降低 代码 量 。 

BackupAgentHelper 的 实现 必须 要 使 用 一 个 或 多 个 backup helper。backup helper 是 一 种 专用 组 
件 ，BackupAgentHelper 用 它 来 对 特定 类 型 的 数据 执行 备份 和 恢复 操作 。 

Android 框架 目前 提供 两 种 helper， 分 别 为 : 

* SharedPreferencesBackupHelper 用 于 备份 SharedPreferences X ft. 

* FileBackupHelper 用 于 备份 内 部 存储 文件 。 


BackupAgentHelper 对 象 中 可 包含 多 个 helper， 但 对 于 每 种 数据 类 型 只 需 用 到 一 个 helpero t 
就 是 说 , 即使 存在 多 个 SharedPreferences 文件 , 也 只 需要 一 个 SharedPreferences-BackupHelper 即 可 
完成 对 文件 的 备份 与 恢复 。 

要 在 BackupAgentHelper 中 加 入 helper， 需 要 在 onCreate0 方 法 中 执行 以 下 步 又 : 
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CL) 实例 化 所 需 的 helper， 并 在 其 构造 方法 中 指定 要 备份 的 文件 。 
@ 02 调用 addHelper0 方 法 ， 把 helper 加 入 BackupAgentHelper。 


使 用 SharedPreferencesBackupHelper 备份 SharedPreferences 的 相关 代码 如 下 : 


public class MyPrefsBackupAgent extends BackupAgentHelper { 
// The name of the SharedPreferences file 
static final String PREFS-"user preferences"; 


// A key to uniquely identify the set of backup data 
static final String PREFS BACKUP KEY-"prefs"; 


// Allocate a helper and add it to the backup agent 

@Override 

public void onCreate() { 
SharedPreferencesBackupHelper helper=new SharedPreferencesBackupHelper (this, PREFS) ; 
addHelper (PREFS BACKUP KEY, helper) ; 


) 


上 面 的 这 几 行 代码 实现 了 一 个 完整 的 备份 代理 MyPrefsBackupAgent. user preferences 是 要 备 
份 的 文件 名 称 。SharedPreferencesBackupHelper 对 象 包含 备份 和 恢复 SharedPreferences 文件 的 所 有 
代码 ， 不 再 需要 开发 者 人 为 书写 。 当 备份 管理 器 调用 onBackup0 方 法 和 onRestore0 方 法 时 ， 
MyPrefsBackupAgent 会 调用 helper 来 完成 对 指定 文件 的 备份 和 恢复 操作 。 

由 于 SharedPreferences 是 线程 安全 的 ， 因 此 可 以 从 备份 代理 和 其 他 Activity 中 安全 地 读 写 
shared preferences 文件 。 

使 用 FileBackupHelper 备份 内 部 存储 文件 的 相关 代码 如 下 : 


public class MyFileBackupAgent extends BackupAgentHelper { 
// The name of the files 
static final String TOP_SCORES="scores"; 
static final String PLAYER_STATS="stats"; 


// A key to uniquely identify the set of backup data 
Static final String FILES BACKUP KEY-"myfiles"; 


// Allocate a helper and add it to the backup agent 

void onCreate()( 
FileBackupHelper helper-new FileBackupHelper (this, TOP SCORES, PLAYER STATS) ; 
addHelper (FILES BACKUP KEY, helper) ; 


) 


HH, scores 和 stats 是 要 保存 的 文件 名 字 ， 上 面 的 代码 定义 的 helper 同时 对 两 个 文件 进行 备 
份 和 恢复 操作 。 

需要 注意 的 是 ， 由 于 读 写 内 部 存储 文件 不 是 线程 安全 的 ， 因 此 要 确保 当 Activity 在 进行 文件 操 
作 时 ， 备 份 代理 不 会 去 读 写 该 文件 ， 每 次 读 写 文件 时 应 该 使 用 同步 语句 。 比 如 在 Activity 读 写 文件 
时 ， 需 要 用 一 个 对 象 作为 同步 语句 的 内 部 锁 。 事 实证 明 ， 长 度 为 零 的 数组 要 比 普通 对 象 更 轻 量化 ， 
更 适合 作为 对 象 锁 使 用 。 

创建 对 象 锁 的 代码 如 下 : 
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// 内 部 锁 对 象 


static final Object[] sDataLock=new Object[0]; 


然后 ， 每 次 读 写 文件 时 就 用 这 个 锁 对 象 创建 同步 语句 。 把 游戏 分 数 写 入 文件 的 同步 代码 如 下 : 


try { 
synchronized (MyActivity.sDataLock) { 
File dataFile=new File (getFilesDir(), TOP_SCORES) ; 
RandomAccessFile raFile-new RandomAccessFile (dataFile, "rw") ; 
raFile.writeInt (score) ; 
} 
) catch (IOException e) { 
Log.e (TAG, "Unable to write to file") ; 
) 


当 读 文 件 时 ， 也 应 该 使 用 同一 个 锁 对 象 创建 同步 语句 。 
然后 ,需要 覆盖 BackupAgentHelper 的 onBackup0 和 onRestore0 方 法 ， 用 同一 个 内 部 锁 同步 备 
份 和 恢复 操作 。 上 例 中 定义 的 MyFileBackupAgent 需要 添加 以 下 方法 : 
@Override 
public void onBackup (ParcelFileDescriptor oldState, BackupDataOutput data, 
ParcelFileDescriptor newState) throws IOException { 
// Hold the lock while the FileBackupHelper performs backup 
synchronized (MyActivity.sDataLock) { 
super.onBackup (oldState, data, newState) ; 
) 
} 


@Override 
public void onRestore (BackupDataInput data, int appVersionCode, 
ParcelFileDescriptor newState) throws IOException ( 
// Hold the lock while the FileBackupHelper restores the file 
synchronized (MyActivity.sDataLock) { 
super.onRestore (data, appVersionCode, newState) ; 
} 
) 


至 此 ， 完 成 了 使 用 FileBackupHelper 进行 文件 备份 和 恢复 操作 的 全 部 工作 。 

2. 核实 恢复 数据 的 版 本 

在 把 数据 备份 到 云 存储 的 过 程 中 ， 备 份 管理 器 会 自动 包含 应 用 程序 的 版 本 号 。 版 本 号 是 由 
manifest 文件 中 的 android:versionCode 属性 定义 的 。 在 调用 备份 代理 恢复 数据 之 前 ， 备 份 管理 器 会 
查询 已 安装 程序 的 android:versionCode 属性 ， 并 与 记录 在 备份 数据 中 的 版 本 号 相 比较 。 如 果 备 份 数 
据 的 版 本 比 设备 上 高 , 就 意味 着 用 户 安装 了 旧版 本 的 应 用 程序 。 这 时 备份 管理 器 将 停止 数据 恢复 操 
作 ，onRestore0 方 法 也 不 会 被 调用 ， 因 为 把 数据 恢复 给 旧版 本 的 应 用 程序 是 没有 意义 的 。 

通过 android:restoreAnyVersion 属性 可 以 替换 以 上 规则 。 此 属性 用 true 或 false 标明 是 否 在 进行 
数据 恢复 时 核实 数据 集 的 版 本 ， 默 认 值 是 false。 如 果 将 其 设 为 te， 备份 管理 器 将 忽略 
android:versionCode 属性 并 且 调 用 onRestore0 方 法 。 这 时 候 应 该 在 onRestore0 方 法 中 人 工 核实 版 本 
信息 ， 并 在 版 本 冲突 时 采取 必要 的 措施 保证 数据 的 兼容 性 。 

为 了 便于 在 恢复 数据 时 对 版 本 号 进行 判断 ，onRestore(0 方 法 把 备份 数据 的 版 本 号 作为 


第 7 章 数据 存储 | 253 





appVersionCode 参数 和 数据 一 起 传 入 方法 中 。 通过 PackageInfo.versionCode 可 以 查询 到 当前 应 用 程 
序 的 版 本 号 ， 相 关 代码 如 下 : 
PackageInfo info; 
try { 
String name=getPackageName () ; 
info=get PackageManager () .getPackageInfo (name,0) ; 
} catch (NameNotFoundException nnfe) { 
info=null; 


} 


int version; 
if (info !=null) { 
version=info.versionCode; 


} 

然后 比较 一 下 传 入 onRestore0 方 法 的 appVersionCode 和 Packagelnfo 的 version 值 即 可 。 

3. 请 求 数据 备份 

应 用 程序 在 任何 时 候 都 可 以 通过 调用 dataChanged0 方 法 来 发 起 备份 请 求 。 此 方法 将 通知 备份 
管理 器 用 备份 代理 来 备份 数据 。 备份 管理 器 将 会 在 合适 的 时 候 调用 备份 代理 的 onBackup0 方 法 。 通 
常 每 次 数据 发 生变 化 时 都 应 该 请 求 备 份 数据 , 但 是 实际 的 备份 次 数 比 请 求 次 数 少 得 多 。 如 果 在 备份 
管理 器 执行 备份 操作 前 连续 请 求 了 很 多 次 ， 备 份 代理 仅 会 执行 一 次 数据 备份 操作 。 

4. 请 求 数据 恢复 

在 应 用 程序 正常 的 生命 周期 内 ， 应 该 不 需要 发 起 恢复 数据 的 请 求 。 在 程序 安装 完成 时 ， 系 统 
会 自动 检查 备份 数据 并 执行 数据 恢复 操作 。 在 必要 时 , 也 可 以 通过 调用 requestRestore() 方 法 人 工 发 
起 恢复 数据 的 请 求 。 这 时 ， 备 份 管理 器 会 调用 onRestore0 方 法 进行 数据 恢复 。 


7.7 小 结 


本 章 着 重 讲述 了 Android 系统 所 提供 的 信息 持久 化 方法 。 其 中 本 地 信息 存储 方式 有 三 种 , 分 别 
为 SharedPreferences、 文 件 存储 和 数据 库存 储 。 进 行 数据 存储 时 ， 要 根据 实际 情况 来 选 定 合适 的 数 
据 存储 方式 。 例 如 ， 当 需要 存储 简单 的 键 值 对 类 型 的 数据 时 ， 使 用 SharedPreference 比较 方便 ， 当 
数据 要 永久 存放 , 方便 以 多 种 途径 查看 时 , 应 使 用 文件 存储 ; 而 经 常 要 读 写 数据 时 , 就 要 用 到 SQlite。 

一 般 情况 下 , 各 种 数据 都 属于 其 应 用 程序 所 私有 。ContentProvider 提供 了 人 允许 在 不 同 应 用 程序 
之 间 共 享 私 有 持久 化 数据 的 接口 。 本 章 演示 了 如 何 对 现 有 的 SQLite 数据 库 建立 自 定义 
ContentProvider， 并 由 其 他 应 用 程序 通过 该 自 定义 ContentProvider 访问 该 数据 库 中 的 数据 的 过 程 。 

网 络 存储 主要 指 借助 于 Google 的 云 计算 平台 App Engine 进行 网 络 数据 同步 以 及 数据 的 备份 与 
恢复 。 借 助 于 信息 同步 技术 ， 可 以 使 用 户 方便 地 在 任何 地 方 获取 存储 在 云端 的 信息 的 最 新 版 本 。 
C2DM 技术 使 用 云端 push 方式 将 数据 从 云端 发 送 至 Android 客户 端 ， 大 幅度 降低 了 Android 客户 
端 与 云端 的 信息 流量 , 节省 了 耗 电量 , 并 且 降 低 了 编程 难度 。 云 端 数据 备份 与 恢复 技术 允许 用 户 将 
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重要 的 应 用 程序 信息 备份 到 云端 服务 器 上 ， 当 用 户 更换 了 Android 系统 的 手机 或 者 重 装 应 用 程序 
时 ， 将 相关 的 信息 自动 恢复 到 用 户 设备 上 。 该 过 程 对 用 户 完全 透明 ， 极 大 地 方便 了 用 户 操作 使 用 ， 
提高 了 用 户 体验 。 


78 J 题 


1. Android 数据 存储 方式 有 哪些 ? 各 有 什么 不 同 ? 

2. ContentProvider 是 如 何 实现 数据 共享 的 ? 

3. 如 何 才 能 使 用 外 部 存储 将 接收 到 的 短信 内 容 写 到 SD 卡 上 的 文件 中 ? 

4. 编写 一 个 ContentProvider 小 应 用 ， 在 一 个 Demo 中 读 取 手机 中 联系 人 的 姓名 ， 并 把 姓名 存 
储 到 SQLite H, H ListView 显示 出 来 。 


Android 系统 提供 的 网 络 编程 方式 基于 Java 语言 , Java 语言 提供 的 网 络 编程 方式 在 Andriod 中 
都 提供 了 支持 。 有 具体 的 编程 方式 包括 : 针对 TCP/IP 协议 的 Socket、ServerSocket 编程 方式 ， 针 对 
UDP 协议 的 DatagramSocket、DatagramPackage 编程 方式 ， 针 对 直接 网 络 URL 访问 的 URL、 
URLConnection 和 HttpURLConnection 方式 ， 等 等 。 本 章 将 对 常见 的 几 种 编程 方式 进行 讲解 。 


8.1 HTTP 通信 


HTTP 英文 全 称 为 Hyper Text Transfer Protocol, 即 超 文本 传输 协议 , 是 一 种 详细 规定 了 浏览 器 
和 万 维 网 (World Wide Web, WWW) 服务 器 之 间 互 相通 信 的 规则 ， 通 过 因特网 传送 万 维 网 文档 的 
数据 传送 协议 。HTTP 协议 采用 请 求 /响应 (Request/Response) 模式 ， 该 工作 模式 单 向 、 同 步 。 在 
客户 端 向 服务 器 发 送 请 求 之 后 ,服务 器 返回 结果 之 前 ,客户 端 只 能 等 待 。 客 户 端 向 服务 器 发 送 一 个 
请 求 ， 请 求 头 包含 请 求 的 方法 、URI、 协 议 版 本 以 及 包含 请 求 修饰 符 、 客 户 信息 和 内 容 的 类 似 于 
MIME 的 消息 结构 。 服 务 器 以 一 个 状态 行 作为 响应 ， 响 应 的 内 容 包括 消息 协议 的 版 本 、 成 功 或 者 错 
误 编码 , 还 包含 服务 器 信息 、 实 体 元 信息 以 及 可 能 的 实体 内 容 。 它 是 一 个 属于 应 用 层 的 面向 对 象 的 
协议 ， 由 于 其 简洁 、 快 速 ， 因 此 适用 于 分 布 式 超 媒体 信息 系统 。 在 Intemet 上 ，HTTP 通信 通常 发 
生 在 TCP/IP 连接 之 上 ， 缺 省 端口 是 80， 但 其 他 的 端口 也 是 可 用 的 。 

Android 是 一 种 以 Linux 为 基础 的 开放 源码 操作 系统 ， 在 其 内 部 包含 一 些 用 于 实现 Android 网 
络 数 据 操作 的 接口 。Android 操作 系统 提供 3 种 网 络 接口 可 供 使 用 ， 它 们 分 别 是 Java 标准 接 
Apache 接口 和 Android 网 络 接 口 。 其 中 ，Java 标准 接口 是 最 常用 的 ， 而 Android 接口 是 Java 标准 
接口 的 补充 。 

接 下 来 ， 我 们 将 分 别 学 习 这 些 接口 ， 分 析 并 使 用 这 些 接口 实现 简单 的 网 络 操作 。 需 要 说 明 的 
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是 , 在 Android 系统 中 开发 Internet 应 用 程序 时 , 需要 在 AndroidManifestxml 文件 中 加 入 如 下 权限 : 


«uses-permission android:name-"android.permission.INTERNET" /» 


1. 标准 Java 接口 


Android 提供 了 java.net.* 包 来 实现 访问 HTTP. 服务 的 基本 功能 ， 其 中 包含 一 些 非 常 实用 的 与 
网 络 操作 相关 的 接口 ， 包 括 流 和 数据 包 套 接 字 、Intemet 协议 、 常 规 HTTP 处 理 等 。 

HTTP 协议 通过 URL (Uniform / Universal Resource Locator， 统 一 资源 定位 符 ， 也 被 称 为 网 页 
地 址 ) 来 定位 资源 。 URL 是 因特网 上 标准 的 资源 的 地 址 (Address)。URL 是 用 于 完整 地 描述 Internet 
上 网 页 和 其 他 资源 的 地 址 的 一 种 标识 方法 。 这 种 地 址 可 以 是 本 地 磁盘 , 也 可 以 是 局 域 网 上 的 某 一 台 
计算 机 ， 更 多 的 是 Intemet 上 的 站 点 。 

URL 由 三 部 分 组 成 :资源 类 型 、 存 放 资 源 的 主机 域名 、 资 源 文 件 名 。 

URL 的 一 般 语 法 格式 为 〈 带 方 括号 “[]” 的 为 可 选项 ) : 

protocol :// hostname[:port] / path / [sparameters] [?query]#fragment 


其 中 的 格式 说 明 如 下 。 
(1) protocol (协议 ) 
protocol 指定 使 用 的 传输 协议 ， 表 8.1 列 出 了 常用 的 protocol 属性 的 有 效 方案 名 称 。 最 常用 的 
Zé HTTP 协议 ， 它 也 是 目前 WWW 中 应 用 最 广 的 协议 。 


表 8.1 protocol 属性 的 有 效 方案 


BRAM | 描述 内 容 


file 资源 是 本 地 计算 机 上 的 文件 ， 格 式 : file:// 


ftp 通过 FTP 访问 资源 ， 格 式 : FTP:/ 

gopher 通过 Gopher 协议 访问 该 资源 ， 格 式 gopher:// 

http 通过 HTTP 访问 该 资源 ， 格 式 : HTTP:// 

https 通过 安全 的 HTTPS 访问 该 资源 ， 格 式 : target= blank>HTTPS:// 


mailto 资源 为 电子 邮件 地 址 ， 通 过 SMTP 访问 ， 格 式 : mailto: 
MMS 通过 支持 MMS 〈 流 媒体 ) 协议 播放 该 资源 (代表 软件 ，Windows Media Player), fX: MMS:// 
ed2k 通过 支持 ed2k 〈 专 用 下 载 链接 ) 协议 的 P2P 软件 访 上 源 ( 代 表 软 件 ， 电 驴 )， 格 式 : ed2k:// 
Flashget ”| 通过 支持 Flashget: (专用 下 载 链接 ) 协议 的 P2P 软件 访问 该 资源 (代表 软件 : 快车 ), 格式 : Flashget:// 
thunder ”| 通过 支持 thunder (专用 下 载 链接 ) 协议 的 P2P 软件 访问 该 资源 (代表 软件 : 迅雷 ), 格式 : thunder:// 
news 通过 NNTP 访问 该 资源 ， 格 式 : mews:// 




















(2) hostname (EHL) 

hostname 是 指 存放 资源 的 服务 器 的 域名 系统 (DNS) 、 主 机 名 或 IP 地 址 。 有 时 在 主机 名 前 
也 可 以 包含 连接 到 服务 器 所 需 的 用 户 名 和 密码 (格式 : username@password) 。 

(3) port (ij A'S) 

port 为 整数 ， 是 可 选 的 ， 省 略 时 使 用 方案 的 默认 端口 ， 各 种 传输 协议 都 有 默认 的 端口 号 ， 如 
HTTP 的 默认 端口 为 80。 若 输入 时 省 略 ， 则 使 用 默认 端口 号 。 有 时 出 于 安全 或 其 他 因素 考虑 ， 可 
以 在 服务 器 上 对 端口 进行 重 定义 ， 即 采用 非 标准 端口 号 ， 此 时 ，URL 中 就 不 能 省 略 端口 号 这 一 
项 。 
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(4) path (路 径 ) 
path 是 由 若干 “/” 符 号 隔 开 的 字符 串 ， 一 般 用 来 表示 主机 上 的 一 个 目录 或 文件 地 址 。 
(5) parameters (#2) 
parameters 用 于 指定 特殊 参数 的 可 选项 。 
(6) query (查询 ) 
query 也 是 可 选项 ， 用 于 给 动态 网 页 (如 使 用 CGI ISAPI, PHP/JSP/ASP/ASP.NET 等 技术 制 
作 的 网 页 ) 传递 参数 ， 可 有 多 个 参数 ， 用 “& ”符号 隔 开 ， 每 个 参数 的 名 和 值 用 “=” 符 号 隔 开 。 
(7) fragment (信息 片断 ) 
fragment 是 字符 串 ， 用 于 指定 网 络 资源 中 的 片断 。 例 如 一 个 网 页 中 有 多 个 名 词 解释 ， 可 使 用 
fragment 直接 定位 到 某 一 名 词 解释 。 
使 用 Java 标准 接口 访问 网 络 资源 的 基本 步骤 如 下 : 
Io) tE URL. 
C€X302 从 URL 创建 URLConnection /HttpURLConnection 对 象 并 设置 连接 参数 。 
EI 连接 到 服务 器 。 
Eo 读 写 服务 器 数据 。 


Java.net.URL 类 用 于 封装 URL 地 址 , 可 以 通过 该 类 与 特定 URL 地 址 建立 连接 并 对 其 中 的 数据 
进行 读 写 操作 。 若 封装 的 URL 地 址 格式 错误 ， 则 URL 构造 方法 会 抛 出 MalformedURLException 
异常 。 

2. Apache 接口 


Apache 实验 室 开 源 的 包 org.apache.http.* 提 供 非 常 丰富 的 网 络 操作 接口 。 弥补 了 java.net.* 灵 活 
性 不 足 的 缺点 ， 对 java.net.* 进 行 封装 ， 功 能 更 加 强大 和 全 面 ， 也 会 给 Android 带 来 更 加 丰富 多 彩 的 
网 络 应 用 。 在 Apache 网 络 接口 中 ， 最 重要 的 是 HttpClient，HttpClient 是 Apache Jakarta Common 
下 的 子 项 目 ， 可 以 用 来 提供 高 效 的 、 最 新 的 、 功 能 丰富 的 、 支持 HTTP 协议 的 客户 端 编程 工具 包 ， 
并 且 它 支持 HTTP 协议 最 新 的 版 本 和 建议 .HttpClient 已 经 应 用 在 很 多 项 目 中 , 比如 Apache Jakarta 
上 很 著名 的 另外 两 个 开源 项 目 Cactus 和 HIMLUnit 都 使 用 了 HttpClient。 它 是 一 个 开源 项 目 ， 功 
能 更 加 完善 ， 为 客户 端的 HTTP 编程 提供 高 效 、 最 新 、 功 能 丰富 的 工具 包 支 持 。Android 平台 引入 
了 Apache HttpClient 的 同时 还 提供 了 对 它 的 一 些 封装 和 扩展 ， 例 如 设置 缺 省 的 HTTP 超时 和 缓存 
大 小 等 。Android 使 用 的 是 目前 最 新 的 HttpClient 4.0 (org.apache.http.*) ， 可 以 将 Apache 视 为 目前 
流行 的 开源 Web 服务 器 ， 主 要 包括 创建 HttpClient 以 及 Get/Post, HttpRequest 等 对 象 、 设 置 连接 
参数 、 执 行 HTTP 操作 、 处 理 服务 器 返回 结果 等 功能 。 
使 用 这 部 分 接口 的 基本 操作 与 java.net.* 基 本 类 似 ， 主 要 包括 : 
(1) 创建 HttpClient， 以 及 GetMethod / PostMethod 和 HttpRequest 等 对 象 。 
(2) 设置 连接 参数 。 
(3) 执行 HTTP 操作 。 
(4) 处 理 服务 器 返回 结果 。 
以 下 列 出 的 是 HttpClient 提供 的 主要 功能 。 
COD 实现 了 所 有 HTTP 的 方法 (GET. POST. PUT. HEAD 等 ) 。 
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(2) 支持 自动 转向 。 
(3) 支持 HITPS 协议 。 
(4) 支持 代理 服务 器 。 
使 用 HttpClient 时 也 需要 注意 请 求 报头 和 响应 报头 ， 以 及 提交 方式 ,因为 它 也 是 遵循 HTTP 协 
议 的 。 下 面 简单 介绍 一 下 常用 的 GET 和 POST 方式 在 代码 实现 上 有 什么 异同 。 
在 GET 方式 下 使 用 HttpClient 需要 几 个 最 基本 的 步骤 : 
Eo) 构造 HttpClient 的 实例 。 
eo 创建 连接 方法 的 实例 ， 这 里 是 HttpGet， 在 HttpGet 的 构造 方法 中 传 入 待 连接 的 路 径 。 
EI 请 求 HttpClient， 调 用 execute 传 入 HttPGet 取得 HttpResponse。 
CX304 读 HttpResponse， 在 读 之 前 判断 连接 状态 是 否 等 于 HttpStatus SC_OK(200)。 
C€X305 对 读 取 的 内 容 进行 处 理 。 


Post 方式 相对 GET 有 些 差 异 并 且 复 杂 一 点 ， 主 要 是 参数 处 理 部 分 有 差异 。 在 POST 方式 下 使 
用 HttpClient 需要 几 个 最 基本 的 步 又: 

Eo) 构造 HttpClient 的 实例 。 

CXX02 向 HttpPost 的 构造 参数 中 传 入 路 径 ， 创 建 POST 连接 。 

EIn 准备 参数 ， 并 且 设置 编码 等 相关 信息 。 

CPs 将 准备 的 参数 设置 到 HttpPost 中 去 ， 方 法 是 HttpPost.setEntity(). 

CX305 得 到 HttpResponse， 通 过 httpClient.execute() 得 到 。 

(206) 读 取 HttpResponse。 

CN? 对 读 取 的 内 容 进行 处 理 。 


需要 注意 的 是 ， 在 网 络 操作 过 程 中 ， 需 要 Android 应 用 拥有 联网 权限 ， 可 以 在 
AndroidManifest.xml 中 写 入 <uses-permission android:name="android.permission. INTERNET"> 


</uses-permission> 权 限 。 

3. Android 网 络 接口 

android.net.* 包 实际 上 是 通过 对 Apache 中 HttpClient 的 封装 来 实现 的 一 个 HTTP 编程 接口 ， 同 
时 还 提供 HTTP 请 求 队列 管理 以 及 HTTP 连接 池 管 理 , 以 提高 并 发 送 请 求情 况 下 的 处 理 效 率 , 除 此 
之 外 ， 还 有 网 络 状态 监视 等 接口 、 网 络 访问 的 Socket、 常 用 的 Uri 类 以 及 有 关 WiFi 相关 的 类 等 。 


8.1.1 访问 URL 指定 资源 


为 了 可 以 通过 AVD 调试 网 络 访问 应 用 程序 ， 首 先 在 本 地 计算 机 上 架设 网 络 服务 器 端 。 使 用 
Tomcat 做 服务 器 ， 在 其 webapps 目录 下 建立 android 目录 ， 并 在 该 目录 下 建立 message jsp 文件 。 
message.jsp 文件 的 具体 代码 如 下 : 


<HTTP> 
<HEAD> 
<TITLE>HTTP-MESSAGE</TITLE> 
</HEAD> 


第 8 章 网 络 编程 | 259 





http 


<BODY> 
«t 
out.println ("«Hl»Http-Message«BR»Android:Hello World«/H»") ; 
E» 
</BODY> 
</HTML> 


由 于 本 地 计算 机 在 网 络 上 的 IP 为 175.168.35.198, D JE messagejsp 的 网 络 URL 为 
://175.168.35.198:8080/android/message.jsp。 将 该 地 址 输入 TE 地 址 栏 打开 ， 其 运行 效果 如 图 8.1 


所 示 。 


大 HTTP-MESSAGE - Windows Internet Explorer So = 


Go-la httpi/175.168.35.198:8080/android/messagejsp h ~/a]4[x]| 


dr MUERE | @ HTTP-MESSAGE fy OP +S m+ mor se9- 








Cy 
a 
s 
! 
b 
1i 

















Http-Message 
Android:Hello World 








完成 @ Internet | 保护 模式 : 启用 fa v R100% ~ 
— 





图 8.1 message.jsp 的 运行 效果 


这 样 ， 我 们 就 有 了 可 以 通过 AVD 来 访问 的 网 络 上 的 资源 。 
使 用 java.net.URLConnection 访问 URL 指定 的 网 络 资源 的 基本 过 程 的 代码 如 下 : 


URL url=new URL ("ftp://mirror.csclub.uwaterloo.ca/index.html") ;// 建 立 URL 

URLConnection urlConnection=url.openConnection();// 打 开 连 接 

InputStream in=new BufferedInputStream (urlConnection.getInputStream() ) ;// 从 连接 建立 输入 流 
try { 

readStream (in) ;// 读 取 数 据 操作 

finally { 

in.close(); 

} 

} 


URLConnection 内 建 对 多 种 网 络 协 议 的 支持 ， 如 HTTP/HTTPS、File、FTP 等 。 
在 创建 连接 之 前 ， 可 以 对 连接 的 一 些 属性 进行 设置 ， 如 表 8.2 所 示 。 


表 8.2 URLConnection 属性 





属性 名 称 属性 描述 
setReadTimeout (3000) 


设置 读 取 数 据 的 超时 时 间 为 3 秒 钟 





setUseCaches (false) 设置 当前 连接 是 否 人 允许 使 用 缓存 





setDoOutput (true) 


设置 当前 连接 是 否 允 许 建立 输出 流 








$3 


setDoInput (true) 


设置 当前 连接 是 否 允 许 建立 输入 流 








HttpURLConnection 继承 于 URLConnection 类 ， 二 者 都 是 抽象 类 ， 所 以 无 法 直接 实例 化 ， 其 对 
E 要 通过 URL 的 openConnection 方法 获得 。 





URLConnection 可 以 直接 转换 成 HttpURLConnection, 以 便于 使 用 一 些 HTTP 连接 特定 的 方法 ， 
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如 getResponseMessage(0、setRequestMethod() 等 。 
使 用 HttpURLConnection 访问 网 络 资源 的 基本 过 程 的 代码 如 下 : 


URL url-new URL ("http://www.android.com/") ; 
HttpURLConnection urlConnection- (HttpURLConnection) url.openConnection(); 


try ( 
InputStream in-new BufferedInputStream (urlConnection.getInputStream()) ; 
readStream (in) ; 
finally ( 
urlConnection.disconnect(); 


需要 注意 的 是 ， 使 用 openConnection 方法 所 创建 的 URLConnection 或 者 HttpURLConnection 
例 不 具有 重用 性 ， 每 次 调用 openConnection 方法 都 将 创建 一 个 新 的 实例 。 
实例 URLDemo 中 演示 了 使 用 URL 访问 指定 资源 的 过 程 ， 运 行 效果 如 图 8.2 所 示 。 























<TITLE>HTTP-MESSAGE</TITLE> 
</HEAD> 
<BODY> 
<H1>Http-Message<BR>Android:Hello 





图 8.2 URLDemo 的 运行 效果 


实例 URLDemo 中 main.xml 的 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android="htt; 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent"> 
«Button 
android: id="@+id/Button HTTP" 
android: layout_width="fill parent" 


://schemas.android.com/apk/res/android" 








android: layout_height="wrap content" 
android:text="@string/button name01"/» 
<TextView 

android: id="@tid/TextView HTTP" 

android: layout_width="fill parent" 

android: layout_height="wrap content" 

/> 
</LinearLayout> 


实例 URLDemo  AndroidManifest.xml 的 代码 如 下 : 
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<?xml version-"1.0" encoding-"utf-8"?» 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 


package-"com.android.activity" 
android:versionCode-"1" 
android:versionName-"1.0"» 


«uses-sdk android:minSdkVersion-"4" /> 


«uses-permission android:name-"android.permission.INTERNET" /> 


«application android:icon-"Gdrawable/ic launcher" android:label-"8string/app name"? 


«activity android:name-".MainActivity" 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name-"android.intent.action.MAIN" /> 
<category android:name="android.intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 


</application> 
</manifest> 


实例 URLDemo 中 MainActivity java 的 具体 实现 代码 如 下 : 


package introdction.android.URLDemo; 


import java.io.BufferedReader; 

import java.io. IOException; 

import java.io. InputStreamReader; 
import java.net.HttpURLConnection; 
import java.net .MalformedURLException; 
import java.net.URL; 

import com.android.activity.R; 

import android.app.Activity; 

import android.os.Bundle; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 

import android.widget.TextView; 


public class MainActivity extends Activity { 


/** Called when the activity is first created. */ 
private TextView textView HTTP; 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
textView HTTP- (TextView) findViewById (R.id.TextView HTTP) ; 
Button button http- (Button) findViewById (R.id.Button HTTP) ; 
button http.setOnClickListener (new OnClickListener() (//Zi button http 按钮 设置 监听 器 
public void onClick (View v) {// 事 件 处 理 
String httpUrl-"http://175.168.35.198:8080/android/message.jsp":; 
String resultData-"";// 定义 一 个 resultData 用 于 存储 获得 的 数据 
URL url-null;// SEX URL 对象 
try { 
url-new URL (httpUrl) ; // 构造 一 个 URL 对 象 时 需要 使 用 异常 处 理 
} catch (MalformedURLException e) { 
System.out.println (e.getMessage ()) ;// 打 印 出 异常 信息 
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if (url !=nul1) {// 如 果 URL 不 为 空 时 
try {// 有 关 网 络 操作 时 ， 需 要 使 用 异常 处 理 
HttpURLConnection urlConn= (HttpURLConnection) url 


-openConnection();// 使 用 HttpURLConnection 打开 连接 
InputStreamReader in=new InputStreamReader (urlConn 
-getInputStream()) ;// 得 到 读 取 的 内 容 
BufferedReader buffer=new BufferedReader (in) ;// 为 输出 创建 
BufferedReader 


String inputLine=null; 
while (((inputLine=buffer.readLine()) !=null)) {// 读 取 获 得 的 数据 


resultDatat=inputLine+"\n";// 加 上 "\n" 实 现 换行 

} 

in.close();// 关闭 InputStreamReader 

urlConn.disconnect ();// 关闭 HTTP 连接 

if (resultData !=null) {// 如 果 获 取 到 的 数据 不 为 空 
textView_HTTP.setText (resultData) ;// 显 示 取 得 的 内 容 


} else { 
textView_HTTP.setText ("Sorry,the content is null") ; 


// 获 取 到 的 数据 为 空 时 显示 
} 
) catch (IOException e) { 


textView HTTP.setText (e.getMessage()) ;// 出 现 异常 时 ， 打 印 出 异常 信息 
} 


} else { 
textView HTTP.setText ("url is null") ;// 当 url 为 空 时 输出 


p: 
) 


代码 中 ，String httpUrl=" http://175.168.35.198:8080/android/message jsp "指定 了 要 访问 的 网 络 
资源 的 地 址 ， 读 者 测试 时 改 成 自己 本 机 的 TP. 地 址 即 可 。 


8.1.2 使 用 GET 方式 获取 网 络 服务 


HTTP 通信 中 可 以 使 用 GET 和 了 POST 方式 ，GET 方式 可 以 获取 静态 页 面 ， 也 可 以 把 参数 放 在 
URL 字符 后 面 传递 给 服务 器 ， 例 如 地 址 “ http://175.168.35.198:8080/android/getMessage. 
jsp?message=Helloworld” 就 是 使 用 GET 方式 ， 在 URL 中 ，“?” 后 面 直接 加 入 参数 message 的 信 
A, mi POST 方式 的 参数 是 放 在 HTTP 请求 中 的 ， 不 会 直接 出 现在 URL 中 。 

与 GET 类似，POST 参数 也 是 被 URL 编码 的 。 然 而 ， 两 者 已 经 有 了 很 多 不 同 : 


(1) GET 是 从 服务 器 上 获取 数据 ，POST 是 向 服务 器 传送 数据 。 

在 客户 端 ，GET 方式 通过 URL 提交 数据 ,数据 在 URL 中 可 以 看 到 ; POST 方式 是 通过 数据 放 
置 在 HTML HEADER 内 提交 。 

(2) 对 于 GET 方式 ， 服务 器 端 用 Request.QueryString 获取 变量 的 值 ， 对 于 POST 方式， 服务 
器 端 用 Request.Form 获取 提交 的 数据 。 
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(3) GET 方式 提交 的 数据 最 多 只 能 有 1024 字 节 ， 而 POST 则 没有 此 限制 。 
(4) 安全 性 问题 。 使 用 GET 的 时 候 ， 参 数 会 显示 在 地 址 栏 上 ， 而 POST 不 会 。 所 以 ， 如 果 这 
些 数据 是 中 文 数 据 而 且 是 非 敏感 数据 ， 那 么 使 用 GET 方式 ; 如 果 用 户 输入 的 数据 不 是 中 文字 符 而 
且 包 含 敏感 数据 ， 那 么 还 是 使 用 POST 方式 为 好 。 
HttpURLConnection 默认 的 访问 方式 为 Get， 以 POST 方式 获取 网 页 数据 时 需要 使 用 
setRequestMethod 方法 设置 访问 方式 为 POST。 
在 TOMCAT 根 目录 下 的 “webappsvandroid” 目 录 下 建立 getMessage.jsp 文件 作为 网 络 服务 资 
源 文件 ， 该 文件 代码 如 下 : 


<%@ page language-"java" import-"java.util.*" pageEncoding="gb2312"%> 


«HTTP» 
<HEAD> 
<TITLE>Get-HTTP-MESSAGE</TITLE> 
</HEAD> 
<BODY> 
<% 
String message-request.getParameter ("message") ; 
String result-new String (message.getBytes ("iso-8859-1") ,"gb2312") ; 
out.println ("<H1>Android-message:"+result+"</H>") ; 
$> 
</BODY> 
</HTML> 


该 文件 从 访问 该 文件 的 request 中 获取 名 为 message 的 参数 信息 并 在 页 面 上 显示 出 来 。 

GET 方式 获取 网 页 数据 的 实现 方式 和 指定 URL 方式 很 相似 , 不 同 的 是 要 在 将 要 访问 的 地 址 后 
面 加 上 要 传递 的 参数 。 

实例 GETDemo 中 演示 了 使 用 GET 方式 访问 指定 网 页 的 过 程 ， 运 行 效果 如 图 8.3 所 示 。 


é 
GET 方 式 获取 数据 


<TITLE>Get-HTTP-MESSAGE</TITLE> 
4EAD> 


ndroid-message:Helloworld</H> 





图 8.3 ”实例 GETDemo 的 演示 过 程 
实例 GETDemo 中 main.xml 的 具体 实现 代码 如 下 : 


<?xml version-"1.0" encoding="utf-8"2> 
<LinearLayout 
xmlns: android="http: //schemas.android.com/apk/res/android" 
android: orientation="vertical" 
android: layout_width="fill parent" 
android: layout_height="fill parent"» 
<Button 
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android: id="@+tid/Button_Get" 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android:text="@string/button name"/> 
<TextView 

android: id="@+id/TextView Get" 

android: layout_width="fill parent" 

android: layout_height="wrap content" 

/> 
</LinearLayout> 


实例 GETDemo 中 AndroidManifest.xml 的 具体 实现 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"com.android.activity" 
android:versionCode-"]" 
android:versionName-"1.0"» 
<uses-sdk android:minSdkVersion-"4" /> 
<uses-permission android:name="android.permission. INTERNET" /> 
<application android: icon="@drawable/ic_ launcher" android: label="@string/app_name"> 
<activity android:name-".MainActivity" 
android: label="@string/app name"> 
<intent-filter> 
<action android:name-"android.intent.action.MAIN" /> 
<category android:name="android. intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
</manifest> 


其 中 ，<uses-permission android:name="android.permission. INTERNET" /> 设置 可 以 访问 网 络 的 
权限 。 
实例 GETDemo 中 MainActivity.java 的 具体 实现 代码 如 下 : 


package introdction.android.getDemo; 
import java.io.BufferedReader; 
import java.io.IOException; 
import java.io.InputStreamReader; 
import java.net .HttpURLConnection; 
import java.net .MalformedURLException; 
import java.net.URL; 
import android.app.Activity; 
import android.os.Bundle; 
import android.view.View; 
import android.view.View.OnClickListener; 
import android.widget.Button; 
import android.widget.TextView; 
public class MainActivity extends Activity { 
private TextView textView Get; 
GOverride 
public void onCreate (Bundle savedInstanceState) ( 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
textView Get- (TextView) findViewById (R.id.TextView Get) ; 
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Button button Get- (Button) findViewById (R.id.Button Get) ; 
button Get.setOnClickListener (new OnClickListener () { 
public void onClick (View v) ( 
String httpUrl-"http:// 175.168.35.198:8080/android/ 
getMessage.jsp?message-Helloworld";String resultData- 

URL url-null; 

try ( 
url-new URL (httpUrl) ; 

) catch (MalformedURLException e) ( 
System.out.println (e.getMessage()) ; 





} 
if (url !=null) { 
try { 
HttpURLConnection urlConn= (HttpURLConnection) url 
-openConnection() ; 
InputStreamReader in-new InputStreamReader (urlConn 
-getInputStream()) ; 
BufferedReader buffer=new BufferedReader (in) ; 
String inputLine=null; 
while (((inputLine=buffer.readLine()) !=null)) { 
resultDatat+=inputLine+"\n"; 
} 
in.close(); 
urlConn.disconnect (); 
if (resultData !=null) { 
textView Get.setText (resultData) ; 


) else { 
textView Get.setText ("Sorry,the content is null") ; 


} catch (IOException e) { 
textView Get.setText (e.getMessage()) ; 
) 


} else | 
textView Get.setText ("url is null") ; 


TP 


HP, String httpUrl= “http://175.168.35.198:8080/android/getMessage.jsp?message=Helloworld” 
设置 要 访问 的 网 页 的 URL, “message=Helloworld” 设 置 要 传递 的 参数 message 的 值 为 Helloworld。 


8.1.3 使 用 POST 方式 获取 网 络 服务 


实例 POSTDemo 中 演示 了 使 用 POST 方式 访问 getMessage.jsp 的 过 程 ,运行 效果 如 图 8.4 所 示 。 
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<HTTP> 


<HEAD> 
<TITLE>Get-HTTP-MESSAGE</TITLE> 
</HEA 
<BODY: 
<H1>Android-message:HelloWorl 


</BODY> 
</HTML> 





图 8.4 实例 POSTDemo 的 运行 效果 


实例 POSTDemo 中 main.xml 的 具体 实现 代码 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
<LinearLayout 
xmlns:android="http: //schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent"» 
«Button 
android: id="@+id/Button_Post" 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
android:text="@string/button name"/> 
<TextView 
android: id="@tid/TextView Post" 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
/> 
</LinearLayout> 





实例 POSTDemo 中 AndroidManifest.xml 的 具体 实现 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android="http://schemas. android. com/apk/res/android" 
package-"com.android.activity" 


android:versionCode-"2" 





android: versionName="1.0"> 
«uses-sdk android:minSdkVersion-"4" /> 
<uses-permission android:name-"android.permission.INTERNET" /> 
«application android: icon="@drawable/ic launcher" android: label="@string/app_name"> 
«activity android:name-".MainActivity" 
android: label="@string/app_name"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android. intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
</manifest> 
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其 中 ， <uses-permission android:name="android.permission INTERNET" 广 设置 可 以 访问 网 络 的 权限 。 
实例 POSTDemo 中 MainActivity java 的 具体 实现 代码 如 下 : 


package introdction.android.postDemo; 
import java.io.BufferedReader; 
import java.io.DataOutputStream; 
import java.io.IOException; 
import java.io.InputStreamReader; 
import java.net.HttpURLConnection; 
import java.net.MalformedURLException; 
import java.net.URL; 
import java.net.URLEncoder; 
import android.app.Activity; 
import android.os.Bundle; 
import android.view.View; 
import android.view.View.OnClickListener; 
import android.widget.Button; 
import android.widget.TextView; 
public class MainActivity extends Activity ( 
private TextView textView Post; 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
textView Post- (TextView) findViewById (R.id.TextView_Post) ; 
Button button Post- (Button) findViewById (R.id.Button Post) ; 
button Post.setOnClickListener (new OnClickListener () { 
public void onClick (View v) ( 
String httpUrl-"http:// 175.168.35.198:8080/android/getMessage. jsp"; 
String resultData-""; 
URL url-null; 
try{ 
url-new URL (httpUrl) ; 
} 
catch (MalformedURLException e) { 
System.out.println (e.getMessage()) ; 
) 
if (url !=null) ( 
try{ 
HttpURLConnection urlConn= (HttpURLConnection) 
url.openConnection(); 
urlConn.setDoOutput (true) ; 
urlConn.setDoInput (true) ; 
urlConn.setRequestMethod ("POST") ; 
urlConn.setUseCaches (false) ; 
urlConn.setInstanceFollowRedirects (true) ; 
urlConn.setRequestProperty ("Content-Type","application/x-www-form-urlencoded") ; 
urlConn.connect () 7 
DataOutputStream out-new DataOutputStream 
CurlConn.getOutputStream()) ; 
String content="message="+URLEncoder.encode ("HelloWorld", 
"gb2312") ; 
out.writeBytes (content) ; 
out.flush(); 
out.close(); 
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BufferedReader reader=new BufferedReader (new InputStreamReader 
(urlConn.getInputStream())) ; 
String inputLine-null; 
while (((inputLine-reader.readLine()) !-null)) { 
resultData+=inputLine+"\n"; 
} 
reader.close(); 
urlConn.disconnect(); 
if ( resultData !=null ) { 
textView Post.setText (resultData) ; 
E 
else { 
textView Post.setText ("Sorry,the content is null") ; 
} 
) 
catch (IOException e) { 
textView Post.setText (e.getMessage()) ; 
) 


) 
else( 
textView Post.setText ("url is null") ; 


D: 


其 中 ，String httpUrl="http:// 175.168.35.198:8080/android/getMessage.jsp" V EL 3E Jj H] flf) URL 地 
hk, urlConn.setRequestMethod ("POST") 设置 访问 方式 为 POST 方式 。 


String content="message="+URLEncoder.encode ("HelloWorld", "gb2312") ; 
out.writeBytes (content) ; 


将 要 传递 的 message 的 值 传递 给 服务 器 。 此 外 ，Android 开发 包 还 提供 了 org.apache.http. 
client.methods.HttpGet 和 org.apache http.clientmethods.HttpPost 两 个 类 , 分 别 用 于 处 理 GET 和 POST 
网 络 访问 方式 ， 此 处 不 再 描述 ， 读 者 可 参看 相关 文档 。 


8.2 Socket 通信 


Socket 编程 方式 是 比较 底层 的 网 络 编程 方式 ， 常 见 的 高 级 网 络 通信 协议 (如 HTTP) 基本 上 都 
是 建立 在 Socket 编程 基础 之 上 的 ， 而 且 Socket 编程 是 跨 平台 的 编程 方式 ， 可 以 在 异 构 语言 之 间 进 
行 通信 ， 所 以 Socket 通信 是 其 他 网 络 编程 方式 的 基础 ， 掌 握 Socket 网 络 编程 方式 是 很 有 意义 的 。 


8.2.1 Socket 简介 


1. 什么 是 Socket 
Socket 的 英文 原 义 是 “ 孔 ” 或 “插座 ”。 作 为 4BDS UNIX 的 进程 通信 机 制 ， 取 后 一 种 意思 。 
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通常 也 称 作 “ 套 接 字 ”， 用 于 描述 IP 地 址 和 端口 ， 是 一 个 通信 和 链 的 句柄 。 在 Intemet 上 的 主机 一 般 
运行 了 多 个 服务 软件 ， 同 时 提供 几 种 服务 。 每 种 服务 都 打开 一 个 Socket， 并 绑 定 到 一 个 端口 上 , 不 
同 的 端口 对 应 于 不 同 的 服务 。 应 用 程序 通常 通过 “ 套 接 字 ” 向 网 络 发 出 请 求 或 者 应 答 网 络 请 求 。 它 
是 支持 TCP/IP 协议 的 网 络 通信 的 基础 操作 单元 。 

Socket 进行 网 络 通信 必须 包含 5 个 组 成 信息 : 连接 使 用 的 协议 、 本 地 主机 的 IP 地 址 、 本 地 进 
程 的 协议 端口 、 远 程 主机 的 IP 地 址 和 远程 进程 的 协议 端口 。 

2. Socket 通信 的 传输 模式 


Socket 有 两 种 传输 模式 ， 分 别 是 面向 连接 的 和 面向 无 连接 的 ， 应 用 程序 运行 时 使 用 哪 一 种 模 
式 是 由 应 用 程序 本 身 需 求 决定 的 。 

面向 连接 的 传输 模式 可 靠 性 比较 好 ， 它 使 用 TCP (Transmission Control Protocol) 协议 。TCP 
协议 属于 传输 层 协 议 ，TCP 提供 IP 环境 下 的 数据 可 靠 传 输 ， 它 提供 的 服务 包括 数据 流传 送 、 可 靠 
数据 传输 、 有 效 流 控 、 全 双 工 操作 和 多 路 复 用 。 通 过 面向 连接 、 端 到 端 和 可 靠 的 数据 包 发送 。 它 是 
事先 为 所 发 送 的 数据 开辟 出 连接 好 的 通道 ,再 进行 数据 发 送 。 在 这 种 传输 模式 下 ,发 送 方 和 接收 方 
必须 首先 取得 Socket 连接 ， 并 且 一 旦 建立 了 连接 ，Socket 就 可 以 使 用 一 个 流 接口 进行 读 写 数据 操 
作 ， 但 是 这 种 传输 模式 的 效率 低 。 

而 面向 无 连接 的 传输 模式 可 靠 性 不 好 ， 使 用 UDP (User Datagram Protocol) 协议 ， 与 TCP 相 
tk, UDP AA IP 提供 可 靠 性 、 流 控 或 差错 恢复 功能 。 一 般 来 说 ，TCP 对 应 的 是 可 靠 性 要 求 高 的 应 
用 , 而 UDP 对 应 的 则 是 可 靠 性 要 求 低 、 传 输 经 济 的 应 用 。TCP 支持 的 应 用 协议 主要 有 Telnet. FTP. 
SMTP 等 ，UDP 支持 的 应 用 层 协 议 主要 有 NFS 网 络 文件 系统 ) 、SNMP (简单 网 络 管理 协议 ) 、 
DNS〈 主 域名 称 系统 ) ~ TFTP (通用 文件 传输 协议 ) 等 。 这 种 模式 的 操作 使 用 数据 报 协 议 ， 一 个 
数据 报 就 是 一 个 独立 的 单元 ， 它 包含 一 次 传输 数据 的 所 有 信息 。 





8.22 Socket 使 用 方法 


在 Java 程序 设计 语言 中 包含 一 个 java.net.* 包 ， 在 这 个 包 中 提供 了 Socket 和 ServerSocket 两 个 
类 ， 它 们 分 别 用 于 表示 网 络 通信 中 双向 连接 的 客户 端 和 服务 器 端 ， 适 应 于 TCP 协议 。 
客户 端 Socket 的 构造 方法 如 表 8.3 所 示 。 


表 8.3 客户 端 Socket 的 构造 方法 








构造 方法 类 型 参数 解释 
id 参数 表示 要 连接 的 H ; port 为 T 
"c T rats 参数 表示 要 连接 的 服务 器 端的 IP 地 址 ; port 为 连接 使 用 的 





address 参数 表示 连接 中 一 方 的 他 地址 ; port 参数 表示 的 是 连接 中 


Socket ( InetAddress address,int boolean 
pe 一 方 的 端口 号 ; stream 参数 用 来 标识 Socket 是 流 Socket 还 是 数据 





stream) 
报 Socket 
参数 表示 连接 中 一 - : 参数 表示 的 是 连接 中 一 
Sodket (Siria lost por) en 方 的 主机 名 ; port 参数 表示 的 是 连接 中 





host 参数 表示 连接 中 一 方 的 主机 名 ; port 参数 表示 的 是 连接 中 一 方 的 


Socket (String hostint portboolean steam) — | 端口 号 ，skeam 参数 用 来 标识 Socket 是 流 Socket 还 是 数据 报 Socket 
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( 续 表 ) 





构造 方法 类 型 参数 解释 

Socket (SocketImpl impl) impl BRE Socket 的 父 类 ， 用 来 创建 ServerSocket 和 Socket 
host 参数 表示 连接 中 一 方 的 主机 名 ; port 参数 表示 的 是 连接 中 一 
方 的 端口 号 ; localAddr 是 本 地 机 器 的 地 址 ; localPort 参数 表示 本 
地 主机 的 端口 号 


服务 器 端 ServerSocket 的 构造 方法 如 表 8.4 所 示 。 








Socket ( String hostint port,InetAddress 
localAddrnt localPort ) 











3x84 服务 器 端 ServerSocket 的 构造 方法 


= 
ServerSocket (int port) port 参数 表示 的 是 连接 中 一 方 的 端口 号 
port 参数 表示 的 是 连接 中 一 方 的 端口 号 ，backlog 表示 请 求 连接 
的 客户 端 队列 长 度 





erverSocket (int portint backlog.InetAddress | port 参 数 表示 的 是 连接 中 一 方 的 端口 号 ;bindAddr 是 ServerSocket 
bindAddr) 


建立 TCP 连接 时 要 指定 端口 号 , 而 0~1023 的 端口 号 是 为 系统 保留 的 , 因此 在 选择 端口 号 的 时 
候 ， 应 该 选择 一 个 大 于 1023 并 且 没 有 被 其 他 应 用 程序 占用 的 端口 号 。 
客户 端 Socket 对 象 的 建立 代码 如 下 : 


Socket socket; 








BufferedReader in; 
PrintWriter out; 
try { 
socket=new Socket ("192.168.0.99",1234) ; 
in-new BufferedReader (new InputStreamReader (socket.getInputStream())) ; 
out-new PrintWriter (socket.getOutputStream(),true) ; 
// 进 行 输入 输出 操作 .… 
in.close(); 
out.close(); 
socket.close(); 
} catch (UnknownHostException e) { 
// TODO Auto-generated catch block 
e.printStackTrace (); 
} catch (IOException e) { 
// TODO Auto-generated catch block 
e.printStackTrace (); 
} 


这 段 代码 创建 了 一 个 通过 1234 端口 连接 IP 地 址 为 “192.168.0.99” 的 服务 器 的 Socket 对 象 ， 
连接 建立 后 ， 通 过 BufferedReader 和 PrintWriter 类 建立 输入 流 和 输出 流 ， 以 便 与 服务 器 传递 数据 。 
当 连 接 使 用 完毕 后 ， 先 关闭 输入 /输出 流 ， 再 关闭 Socket 连接 。 

服务 器 端的 ServerSocket 对 象 建 立 后 需要 不 断 监听 指定 端口 , 当 有 客户 端 请 求 时 , 调用 accept() 
方法 接受 请 求 并 做 相应 的 处 理 。 需 要 注意 的 是 ，accept0 方 法 是 一 个 阻塞 函数 ， 该 方法 被 调用 后 将 
阻塞 进程 ， 等 待 客户 端 请 求 ， 直 到 有 客户 端 请 求 启动 并 请 求 连接 到 该 端口 ， 然 后 accept0 返 回 一 个 
对 应 于 客户 的 Socket， 例 如 : 


ServerSocket server=null; 
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try 


server-new ServerSocket (1234) ; 


Socket socket-server.accept(); 


in-new BufferedReader (new InputStreamReader (socket.getInputStream())) ; 


out-new PrintWriter (socket.getOutputStream(),true) ; 


// 进 行 输入 输出 操作 


in.close(); 


out.close(); 


} catch (IOException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 


$ 


该 代码 表示 在 服务 器 端 创建 了 一 个 监听 1234 端口 的 ServerSocket 对 象 ， 当 该 端口 有 客户 端 请 
求 发 生 时 ， 创 建 Socket 对 象 与 客户 端 进行 连接 ， 之 后 就 可 以 通过 输入 流 和 输出 流 与 客户 端 进行 数 
据 交 换 。 当 然 ， 这 几 行 代码 仅 是 示例 代码 ， 只 能 处 理 一 个 客户 端 请 求 。 在 实际 的 工程 开发 中 ， 服 务 
器 端的 处 理 方式 应 该 是 ， 当 检测 到 有 客户 端 进行 请 求 时 ， 建 立新 的 线程 与 客户 端 进行 连接 。 





8.2.3 ”Socket 编程 实例 





通过 java.net 包 下 的 DatagramSocket 和 DatagramPacket 类 可 以 方便 地 开发 基于 UDP 协议 的 网 
络 传输 应 用 程序 。 下 面 编 写 一 个 由 Android 手机 客户 端 向 PC 服务 器 端 发 送信 息 的 小 程序 ， 客 户 端 
详细 代码 记录 在 实例 SocketClientDemo 中 ， 服 务 器 端 由 纯 Java 开发 ， 详 细 代 码 在 实例 
SocketServerDemo 中 ， 运 行 效果 如 图 8.5 所 示 。 


手机 客户 端 运行 效果 如 


开始 发 送 数据 … 


图 8.5 Socket 编程 效果 


图 8.6 所 示 。 
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图 8.6 手机 客户 端 运行 效果 
实例 SocketServerDemo 中 Server java 的 具体 实现 代码 如 下 : 
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package introduction.android.server; 


import java.io.IOException; 
import java.net.DatagramPacket; 
import java.net.DatagramSocket; 
import java.net.SocketException; 


public class Server { 


public static void main (String[] args) ( 
// TODO Auto-generated method stub 
// 创建 一 个 DatagramSocket 对 象 ， 并 指定 监听 的 端口 号 
DatagramSocket socket; 
try { 
socket=new DatagramSocket (12345) ; 
byte data[]=new byte[1024]; 
// 创建 一 个 空 的 DatagramPacket HR 
DatagramPacket packet=new DatagramPacket (data, data.length) ; 
// 使 用 receive 方法 接收 客户 端 所 发 送 的 数据 
while (true) { 
try { 
socket.receive (packet) ; 
String result-new String (packet.getData(), 
packet.getOffset(), packet.getLength()) ; 
System.out.println (result) ; 
) catch (IOException e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 
} 
} 
} catch (SocketException el) { 
// TODO Auto-generated catch block 
el.printStackTrace(); 


) 


Server java 在 PC 服务 器 端 建立 DatagramSocket 对 象 , 并 监听 12345 端口 。 当 有 客户 端 请 求 时 ， 
从 该 端口 读 取 客 户 端 传 入 的 数据 ， 并 打印 出 来 。 
实例 SocketClientDemo 的 AndroidManifestxml 中 需要 注册 访问 网 络 的 相关 权限 ， 代 码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"introduction.android.udpDemo" 
android:versionCode-"1" 
android:versionName-"1.0"» 
Xuses-sdk android:minSdkVersion-"4" /> 
«uses-permission 
android:name-"android.permission.ACCESS NETWORK STATE"»«/uses-permission» 
«uses-permission android:name-"android.permission.INTERNET"»«/uses-permission» 
«application android:icon-"6drawable/icon" android:label-"8string/app name"» 
«activity android:name-".UdpClient" 
android: label="@string/app_name"> 
<intent-filter> 


<action android:name="android.intent.action.MAIN" /> 
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<category android:name-"android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 


</application> 
</manifest> 


实例 SocketClientDemo 中 UdpClient java 的 具体 实现 代码 如 下 : 


package introduction.android.udpDemo; 


import java.net.DatagramPacket; 
import java.net.DatagramSocket; 
import java.net.InetAddress; 


import android.app.Activity; 

import android.os.Bundle; 

import android.os.Handler; 

import android.os.Message; 

import android.util.Log; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 

import android.widget.EditText; 


public class UdpClient extends Activity { 
private Button btn listen; 
private EditText et; 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
et- (EditText) findViewById (R.id.editTextl) ; 
btn listen- (Button) findViewById (R.id.btn listen) ; 
btn listen.setOnClickListener (new OnClickListener () { 
@Override 
public void onClick (View v) { 
// TODO Auto-generated method stub 
et.setText 〈" 开 始 发 送 数据 ...") ; 


new ServerThread().start(); 


ps 


class ServerThread extends Thread ( 
public void run()( 
try { 
// 首 先 创建 一 个 DatagramSocket MR 
DatagramSocket socket=new DatagramSocket (12344) ; 


// 创 建 一 个 Inetaddree， 自 己 测试 的 时 候 要 设置 成 自己 本 机 的 IP 地 址 


InetAddress serverAddress-InetAddress.getByName ("169.254.31.8") ; 


while (true) { 


String str="Hi, this is the string from the Android Client!"; 


byte data []-str.getBytes(); 


// 创 建 一 个 DatagramPacket 对 象 ， 并 指定 要 将 这 个 数据 包 发 送 到 网 络 当中 的 哪个 地 址 ， 
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以 及 端口 号 
DatagramPacket packet=new DatagramPacket 
(data, data. length, serverAddress, 12345) ; 
// 调 用 socket HRM send 方法 ， 发 送 数据 
socket.send (packet) ; 
Log.d ("server", "sending...") ; 
Thread.sleep (1000) ; 
) 
} catch (Exception e) { 
// TODO Auto-generated catch block 
e.printStackTrace(); 


5 
} 
UdpClient java 在 手机 客户 端 创 建 DatagramSocket 对 象 ， 并 请 求 与 卫 地址 为 “169.254.31.8” 的 主机 
进行 UDP 连接 。 当 连接 建立 后 ， 将 要 传递 的 信息 封装 在 DatagramPacket 对 象 中 ， 并 通过 
DatagramSocketsend() 方 法 发 送出 去 。 


8.3 Bluetooth 通信 


8.3.1 Bluetooth 简介 


WA (Bluetooth) 技术 是 一 种 支持 设备 短 距离 通信 的 无 线 电 技术 ， 作 用 范围 在 10 米 左右 。 通 
过 蓝牙 技术 可 以 在 移动 电话 、PDA、 无 线 耳 机 、 笔 记 本 电脑 等 众多 设备 之 间 进 行 无 线 信息 的 交换 。 

1998 年 5 月 ， 爱 立信、 诺基亚 、 东 芝 、IBM 和 英特尔 公司 5 家 著名 厂商 在 联合 开展 短程 无 线 
通信 技术 的 标准 化 活动 时 提出 了 蓝牙 技术 。 蓝 牙 这 个 名 字 来 源 于 十 世纪 的 一 位 丹麦 国王 Harald 
Blatand， 其 宗旨 是 提供 一 种 短 距离 、 低 成 本 的 无 线 传 输 应 用 技术 。 利 用 “蓝牙 ”技术 能 够 有 效 地 
简化 移动 通信 终端 设备 之 间 的 通信 ， 也 能 够 成 功 地 简化 设备 与 Intemet 之 间 的 通信 ， 从 而 使 数据 传 
输 变 得 更 加 迅速 高 效 ， 为 无 线 通信 拓宽 道路 。 蓝 牙 技 术 基 于 无 线 技术 ， 采 用 分 散 式 网 络 结构 以 及 快 
跳 频 和 短 包 技术 ， 支 持 点 对 点 通信 ， 使 用 ISM (Industrial Scientific Medical， 工 业 、 科 学 、 医 学 ) 
频率 的 波段 (2.45GHz) ， 在 无 线 设备 的 电气 特性 支持 下 ， 通 过 特定 的 通信 协议 栈 进行 通信 。 

Android SDK 对 于 蓝牙 技术 从 2.0 版 本 的 开始 支持 。Android 包含 对 蓝牙 网 络 协议 栈 的 支持 ， 
这 使 得 蓝牙 设备 能 够 无 线 连接 其 他 蓝牙 设备 交换 数据 。Android 的 应 用 程序 框架 提供 了 访问 蓝牙 功 
能 的 API, 这 些 API 使 得 应 用 程序 能 够 无 线 连接 其 他 蓝牙 设备 , 实现 点 对 点 及 点 对 多 点 的 无 线 交 互 
功能 。 

从 目前 来 看 ， 手 机 是 蓝牙 技术 的 最 大 应 用 领域 ， 也 是 已 经 有 实际 应 用 的 领域 。 几 乎 所 有 的 
Android 系统 手机 都 支持 蓝牙 技术 。 通 过 在 手机 中 植 入 蓝牙 技术 ， 可 以 实现 无 线 耳 机 、 车 载 电话 等 
功能 ， 还 能 实现 手机 与 计算 机 或 与 其 他 手持 设备 的 无 电缆 连接 。 
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8. 


3.2 Android 系统 的 蓝牙 通信 功能 
Android 系统 提供 蓝牙 API 包 android.bluetooth， 人 允许 手机 设备 通过 蓝牙 与 其 他 设备 进行 无 线 
Android 的 蓝牙 API 可 提供 以 下 功能 : 
e 查找 并 配对 蓝牙 设备 。 
e 建立 RFCOMM 通道 。 
© 通过 服务 发 现 (Device Discovery) 与 其 他 无 线 设备 进行 连接 。 
e 与 其 他 设备 进行 蓝牙 数据 传输 。 
e 管理 多 个 蓝牙 连接 。 


需要 说 明 的 是 , Android 模拟 器 不 支持 蓝牙 功能 , 因此 蓝牙 相关 的 应 用 程序 只 能 在 真 机 上 调试 。 
要 使 用 蓝牙 功能 ， 需 要 在 AndroidManifest.xml 中 声明 相应 权限 。 蓝 牙 权限 有 两 种 ， 分 别 为 : 
<uses-permission android:name="android.permission.BLUETOOTH" /> 

或 者 

<uses-permission android:name="android.permission.BLUETOOTH ADMIN" /> 


如 果 想 在 应 用 程序 中 请 求 或 者 建立 蓝牙 连接 并 传递 数据 ， 必 须 声 明 Bluetooth 权限 。 若 想 初始 





化 设备 发 现 功 能 或 者 对 蓝牙 设置 进行 更 改 ， 则 必须 声明 BLUETOOTH_ADMIN 权限 。 


要 在 应 用 程序 中 使 用 蓝牙 功能 ， 必 须 保证 当前 设备 具有 蓝牙 并 且 启 用 该 功能 。 若 当前 设备 支 


持 蓝 牙 ， 但 是 没有 启用 相关 功能 ， 则 需要 人 工 启 用 蓝牙 功能 。 首 先 使 用 BluetoothAdapter 类 的 对 象 
来 确认 设备 具有 蓝牙 功能 ， 然 后 使 用 Intent 开启 蓝牙 功能 。 相 关 代码 如 下 : 


BluetoothAdapter mBluetoothAdapter=BluetoothAdapter.getDefaultAdapter () ; 
if (mBluetoothAdapter==null) { 
// 设备 不 支持 蓝牙 功能 


return; 


) 

// 设 备 支持 蓝牙 功能 

if (!mBluetoothAdapter.isEnabled()) { 
// 用 于 启动 蓝牙 功能 的 Intent 

Intent enableBtIntent=new Intent (BluetoothAdapter.ACTION_REQUEST_ENABLE) ; 
startActivityForResult (enableBtIntent, REQUEST ENABLE BT) ; 

) 


startActivityForResult CenableBtIntent REQUEST ENABLE BT) 














调用 后 , 会 显示 如 图 8.7 所 示 的 对 话 框 ， 要 求 用 户 确认 是 否 启用 蓝 ine lese 
牙 功 能 。 若 用 户 单 击 Yes 按钮 ， 则 Android 系统 会 启用 蓝牙 功能 。 — SER 
SS ee DE ole mE F turn on Bluetooth, Do you 
RESULT OK; 若 蓝牙 功能 启用 失败 或 者 用 户 单 击 No 按钮 ， 则 返 wantto do this? 





El 


RESULT_CANCELED. 
通过 BluetoothAdapter 类 对 象 可 以 发 现 其 他 的 蓝牙 设备 。 在 启 





动 设备 发 现 服务 前 ， 应 该 首先 对 配对 设备 列表 进行 查询 ， 以 确定 ”图 8.7 请 求 启用 蓝牙 功能 对 话 框 
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要 连接 的 无 线 设 备 是 否 已 知 。 配对 设备 列表 中 存储 了 以 前 配对 过 的 蓝牙 设备 的 基本 信息 , 如 设备 名 
称 、 设 备 类 型 、 设 备 的 MAC 地 址 等 。 通过 设备 列表 查找 设备 可 以 节省 大 量 查 找 时 间 。 查 询 设 备 列 
表 的 代码 如 下 : 
Set«BluetoothDevice»pairedDevices-mBluetoothAdapter.getBondedDevices (); 
// 已 配对 设备 列表 存在 
if (pairedDevices.size()>0) { 
// 列表 内 循环 查找 
for (BluetoothDevice device : pairedDevices) { 
// 将 列表 内 的 设备 名 字 添 加 到 ArrayAdapter 中 
mArrayAdapter.add (device.getName()+"\n"+device.getAddress()) ; 


) 
当 设 备 列表 中 未 发 现 要 连接 的 设备 时 ， 需 要 启动 设备 发 现 服务 来 发 现 远 端 蓝牙 设备 ， 扫 描 周 
围 无 线 设备 的 时 间 为 12 秒 钟 左右 。 启 动 设 备 发 现 服务 的 方法 很 简单 ， 只 要 调用 startDiscovery077 


法 即 可 。 但 是 为 了 接收 设备 发 现 服务 返回 的 设备 信息 ， 应 用 程序 需要 注册 用 于 接收 含有 
ACTION FOUND 消息 的 Intent 的 BroadcastReceiver。 其 代码 如 下 : 














private final BroadcastReceiver mReceiver=new BroadcastReceiver () { 
public void onReceive (Context context, Intent intent) { 
String action=intent.getAction(); 
// 发 现 服务 发 现 远 端 设备 时 
if (BluetoothDevice.ACTION FOUND.equals (action)) { 
// 从 Intent 对 象 中 获取 BluetoothDevice 对 象 信息 
BluetoothDevice device-intent.getParcelableExtra (BluetoothDevice.EXTRA DEVICE); 
// 当 发 现 的 新 设备 不 存在 于 设备 配对 列表 中 时 ， 将 设备 的 名 字 和 地 址 添加 到 ArrayAdapter 中 
if (device.getBondState () !=BluetoothDevice.BOND BONDED) { 
mArrayAdapter.add (device.getName ()+"\n"+device.getAddress ()) ; 
n 
) 
) 
] 
// 注 册 BroadcastReceiver 
IntentFilter filter=new IntentFilter (BluetoothDevice.ACTION_FOUND) ; 
registerReceiver (mReceiver, filter) ; 


使 用 registerReceiver() 方 式 注册 的 BroadcastReceiver， 在 应 用 程序 结束 时 要 记得 注销 。 

蓝牙 设备 间 建 立 连接 的 过 程 和 TCP 连接 的 过 程 很 相似 。 服务 器 端 提供 BluetoothServerSocket 类 在 服 
务 器 端 进行 监听 ， 当 有 客户 端 连接 请 求 时 ， 用 于 建立 连接 ;客户 端 提供 BluetoothSocket 类 用 于 对 
蓝牙 服务 提交 连接 请 求 ， 并 建立 连接 。 

服务 器 端 处 理 连 接 请 求 的 示例 代码 如 下 : 


private class AcceptThread extends Thread { 
private final BluetoothServerSocket mmServerSocket; 
private final String NAME-"MY BLUETOOTH SERVICE"; 
public AcceptThread() { 
BluetoothServerSocket tmp-null; 
try ( 
// MY_UUID 用 于 唯一 标识 当前 的 蓝牙 服务 ， 在 建立 连接 时 会 被 客户 端 使 用 
tmp-mBluetoothAdapter.listenUsingRfcommWithServiceRecord (NAME, MY UUID) ; 
) catch (IOException e) { } 
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UUID (Universally Unique Identifier) 为 通用 唯一 识别 码 ， 是 一 个 128 位 的 字符 串 ， 在 该 处 用 
于 唯一 标识 蓝牙 服务 。 客 户 端 通过 UUD 搜寻 到 该 服务 。 
客户 端 用 于 请 求 连接 的 示例 代码 如 下 : 
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) catch (IOException closeException) { } 
return; 

} 

// 连 接 已 建立 ， 在 单独 的 线程 中 对 连接 进行 管理 


manageConnectedSocket (mmSocket) ; 


public void cancel () { 
try { 
mmSocket.close(); 
) catch (IOException e) ( } 


) 


由 于 连接 建立 的 过 程 会 阻塞 进程 ， 属 于 耗 时 操作 ， 因 此 连接 的 建立 和 管理 都 需要 在 单独 的 线 
程 中 进行 。 在 实际 的 工程 开发 过 程 中 , 建立 蓝牙 连接 的 技巧 是 将 每 个 蓝牙 设备 初始 化 为 服务 器 端 并 
监听 连接 ， 这 样 每 个 设备 都 可 以 自动 在 服务 器 端 和 客户 端 之 间 进 行 转化 。 

从 已 经 建立 的 连接 中 读 取 和 写 入 数据 的 过 程 也 属于 耗 时 操作 ， 因 此 也 应 该 在 单独 的 线程 中 进 
行 。 通 过 getInputStream() 和 getOutputStream0 方 法 可 以 获取 输入 流 InputStream 和 输出 流 
OnutputStream， 通 过 read (byte[]) 和 write (byte[]) 方法 可 以 对 数据 进行 读 写 。 示 例 代 码 如 下 : 

private class ConnectedThread extends Thread { 

private final BluetoothSocket mmSocket; 


private final InputStream mmInStream; 
private final OutputStream mmOutStream; 





public ConnectedThread (BluetoothSocket socket) { 
mmSocket-socket; 
InputStream tmpIn-null; 
OutputStream tmpOut-null; 


// Get the input and output streams, using temp objects because 
// member streams are final 
try ( 
tmpIn-socket.getInputStream(); 
tmpOut-socket.getOutputStream(); 
) catch (IOException e) { } 


mmInStream-tmpIn; 
mmOutStream-tmpOut; 
) 


public void run(){ 
byte[] buffer-new byte[1024]; 
// 持续 监听 InputStream 
while (true) { 
try { 
// 读 取 InputStream 的 数据 
bytes=mmInStream.read (buffer) ; 
// 更 新 UI 
mHandler.obtainMessage (MESSAGE READ, bytes, -1, buffer) 
-sendToTarget () ; 
) catch (IOException e) { 
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break; 


} 
public void write (byte[] bytes) { 
try { 
mmOutStream.write (bytes) ; 
) catch (IOException e) ( } 
} 
public void cancel()( 
try { 
mmSocket.close(); 
) catch (IOException e) { } 


8.3.3 ”蓝牙 通信 实例 


实例 BluetoothDemo 演示 了 使 用 蓝牙 功能 对 其 他 蓝牙 设 
备 进行 搜寻 、 连 接 并 进行 数据 传输 的 过 程 。 该 应 用 程序 的 运 
行 效果 如 图 8.8 所 示 。 

该 视图 整体 使 用 LinearLayout 布局 ， 使 用 ListView 显示 
聊天 内 容 ， 下 方 的 横向 LinearLayout 布局 中 放置 了 一 个 用 于 
输入 文本 的 EditText 和 一 个 按钮 。 对 应 的 布局 文件 main.xml 
的 内 容 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
<LinearLayout 
xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:myapp-"http://schemas.android.com/apk/res/c 
om.android.BluetoothChat" 
android:orientation-"vertical" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:background="@drawable/bg01" 
> 


<ListView android:id="@+tid/in" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:stackFromBottom- "true" 
android:transcriptMode-"alwaysScroll" 
android:layout weight-"1" 
/> 
<LinearLayout 
android: orientation="horizontal" 
android: layout_width="match parent" 
android: layout height-"wrap content" 
> 
XEditText android:id="@tid/edit_text_out” 





蓝牙 Demo dd 
我 : 连接 成 功 
lv: 收 到 信息 

图 8.8 实例 BluetoothDemo 的 运行 效果 
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android: layout_width="wrap content" 


android: layout_height="wrap content" 





android: layout_weight="1" 
android: layout_gravity="bottom" 
/> 
<Button android:id="@+id/button send" 


android: 





ayout_width="wrap content” 





android: layout_height="wrap content" 
android: text="@string/send" 
/> 
</LinearLayout> 
</LinearLayout> 


实例 BluetoothDemo 的 AndroidManifest.xml 文件 的 内 容 如 下 : 


<?xml version-"1.0" encoding="utf-8"?> 
<manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package="introduction. android. BluetoothChat" 
android: versionCode="1" 
android: versionName="1.0"> 
<uses-sdk minSdkVersion-"14" /> 
<uses-permission android:name="android.permission.BLUETOOTH ADMIN" /> 
<uses-permission android:name-"android.permission.BLUETOOTH" /> 


<application android: label="@string/app_name" 
android: icon="@drawable/app icon"> 
<activity android:name-".BluetoothChat" 
android: label="@string/app name" 
android: configChanges="orientation| keyboardHidden"> 
<intent-filter> 
<action android:name-"android.intent.action.MAIN" /> 
<category android:name="android. intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 


«activity android:name-".DeviceList" 
android:label-"6string/select device" 
android: theme="@android:style/Theme.Dialog" 
android: configChanges="orientation|keyboardHidden" /> 


</application> 
</manifest> 


实例 BluetoothDemo 的 主 Activity 为 BluetoothChat， 其 对 应 的 文件 内 容 如 下 : 


package introduction.android.BluetoothChat; 


import android.app.Activity; 

import android.bluetooth.BluetoothAdapter; 
import android.bluetooth.BluetoothDevice; 
import android.content. Intent; 

import android.os.Bundle; 

import android.os.Handler; 

import android.os.Message; 

import android.view.KeyEvent; 

import android.view.Menu; 
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import android.view.MenuInflater; 

import android.view.MenuItem; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.view.Window; 

import android.view.inputmethod.EditorInfo; 
import android.widget.ArrayAdapter; 
import android.widget.Button; 

import android.widget.EditText; 

import android.widget.ListView; 

import android.widget.TextView; 

import android.widget.Toast; 


public class BluetoothChat extends Activity ( 


public static final int MESSAGE STATE CHANGE-1; 
public static final int MESSAGE READ-2; 

public static final int MESSAGE WRITE-3; 

public static final int MESSAGE DEVICE NAME-4; 
public static final int MESSAGE TOAST-5; 

public static final String DEVICE NAME-"device name"; 
public static final String TOAST-"toast"; 

private static final int REQUEST CONNECT DEVICE-1; 
private static final int REQUEST ENABLE BT-2; 
private TextView mTitle; 

private ListView mConversationView; 

private EditText mOutEditText; 

private Button mSendButton; 

private String mConnectedDeviceName-null; 

private ArrayAdapter<String>mConversationArrayAdapter; 
private StringBuffer mOutStringBuffer; 

private BluetoothAdapter mBluetoothAdapter-null; 
private ChatService mChatService-null; 


@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 


// 设置 窗口 布局 为 自 定义 标题 
requestWindowFeature (Window. FEATURE CUSTOM TITLE) ; 
setContentView (R.layout.main) ; 


// 设置 窗口 标题 布局 文件 
getWindow().setFeatureInt (Window. FEATURE CUSTOM TITLE, 
R.layout.custom title) ; 


mTitle- (TextView) findViewById (R.id.title left text) ; 
mTitle.setText (R.string.app name) ; 
mTitle- (TextView) findViewById (R.id.title right text) ; 


// 得 到 本 地 蓝牙 适配器 
mBluetoothAdapter=BluetoothAdapter.getDefaultAdapter(); 


// 车 当前 设备 不 支持 蓝牙 功能 
if (mBluetoothAdapter--null) { 
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private TextView.OnEditorActionListener mWriteListener-new 
TextView.OnEditorActionListener () { 


public boolean onEditorAction (TextView view, int actionId, 


KeyEvent event) { 


if (actionId--EditorInfo.IME NULL 


&& event.getAction()--KeyEvent.ACTION UP) ( 
String message=view.getText ().toString(); 
sendMessage (message) ; 


return true; 


private final 


Handler mHandler-new Handler () { 


@Override 

public void handleMessage (Message msg) { 
switch (msg.what) { 
case MESSAGE STATE CHANGE: 


case 


case 


case 


switch (msg.argl) { 

case ChatService. STATE CONNECTED: 
mTitle.setText (R.string.title connected to) ; 
mTitle.append (mConnectedDeviceName) ; 
mConversationArrayAdapter.clear(); 
break; 

case ChatService.STATE CONNECTING: 
mTitle.setText (R.string.title connecting) ; 
break; 

case ChatService.STATE LISTEN: 

case ChatService.STATE NONE: 
mTitle.setText (R.string.title not connected) ; 
break; 

} 

break; 

MESSAGE WRITE: 

byte[] writeBuf- (byte[]) msg.obj; 


String writeMessage-new String (writeBuf) ; 
mConversationArrayAdapter.add ("我 : "4writeMessage) ; 
break; 

MESSAGE READ: 

byte[] readBuf- (byte[]) msg.obj; 


String readMessage-new String (readBuf, 0, msg.argl) ; 

mConversationArrayAdapter.add (mConnectedDeviceName+": " 
+readMessage) ; 

break; 

MESSAGE DEVICE NAME: 


mConnectedDeviceName-msg.getData().getString (DEVICE NAME) ; 
Toast.makeText (getApplicationContext (), 
"链接 到 "«mConnectedDeviceName, Toast.LENGTH SHORT) 
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return true; 
case R.id.discoverable: 


ensureDiscoverable(); 


return true; 
case R.id.back: 


finish(); 
System.exit (0) ; 
return true; 

» 

return false; 


) 


Activity BluetoothChat 的 onCreate( 方 法 检查 当前 设备 是 否 支 持 蓝牙 功能 ， 并 得 到 本 地 的 
BluetoothAdapter 设备 。 在 onStart0 中 检查 是 否 启用 了 蓝牙 功能 ， 若 未 启用 ， 则 请 求 启用 ， 然 后 通 
过 setupChat0 方 法 对 界面 中 的 控件 进行 初始 化 、 增 加 单 击 监听 器 等 ，BluetoothChat 创建 了 
ChatService 对 象 ， 该 对 象 在 整个 应 用 过 程 中 存在 ， 并 完成 了 蓝牙 连接 的 建立 、 消 息 发 送 与 接收 等 
功能 。 

ChatService.java 的 代码 如 下 : 


package introduction.android.BluetoothChat; 


import java.io.IOException; 

import java.io.InputStream; 

import java.io.OutputStream; 

import java.util.UUID; 

import android.bluetooth.BluetoothAdapter; 
import android.bluetooth.BluetoothDevice; 
import android.bluetooth.BluetoothServerSocket; 
import android.bluetooth.BluetoothSocket; 
import android.content.Context; 

import android.os.Bundle; 

import android.os.Handler; 

import android.os.Message; 


public class ChatService { 
private static final String NAME="BluetoothChat"; 


// UUID--> 通 用 唯一 识别 码 ， 能 唯一 辨识 资讯 
private static final UUID MY UUID=UUID 
. fromString ("fa87c0d0-afac-11de-8a39-0800200c9a66") ; 


private final BluetoothAdapter mAdapter; 
private final Handler mHandler; 

private AcceptThread mAcceptThread; 
private ConnectThread mConnectThread; 
private ConnectedThread mConnectedThread; 
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private int mState; 


public static final int STATE NONE-0; 
public static final int STATE LISTEN-1; 
public static final int STATE CONNECTING-2; 
public static final int STATE CONNECTED-3; 


public ChatService (Context context, Handler handler) { 
mAdapter-BluetoothAdapter.getDefaultAdapter();: 
mState-STATE NONE; 
mHandler-handler; 


private synchronized void setState (int state) ( 


mState-state; 
mHandler.obtainMessage (BluetoothChat.MESSAGE STATE CHANGE, state, -1) 
-sendToTarget () ; 


public synchronized int getState() { 
return mState; 


public synchronized void start (){ 


if (mConnectThread !-null) { 
mConnectThread.cancel(); 
mConnectThread-null; 


if (mConnectedThread !-null) { 
mConnectedThread.cancel(); 
mConnectedThread-null; 


if (mAcceptThread--null) { 
mAcceptThread-new AcceptThread(); 
mAcceptThread.start(); 

» 

setState (STATE LISTEN) ; 


// 取消 CONNECTING 和 CONNECTED 状态 下 的 相关 线程 ， 然 后 运行 新 的 mConnectThread 线程 
public synchronized void connect (BluetoothDevice device) { 


if (mState==STATE CONNECTING) { 
if (mConnectThread !-null) { 
mConnectThread.cancel(); 


mConnectThread-null; 


if (mConnectedThread !-null) ( 
nConnectedThread.cancel () ; 
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mConnectedThread-null; 


mConnectThread-new ConnectThread (device) ; 
mConnectThread.start() ; 
setState (STATE CONNECTING) ; 


// 开启 一 个 ConnectedThread 来 管理 对 应 的 当前 连接 。 之 前 先 取消 任意 现存 的 mconnectThread 、 
// mConnectedThread 、 mAcceptThread 线程 ， 然 后 开启 新 mConnectedThread ， 传 入 当前 刚刚 接受 的 
// socket 连接 
// 最 后 通过 Handler 来 通知 UI 连接 
public synchronized void connected (BluetoothSocket socket, 
BluetoothDevice device) { 


if (mConnectThread !=null) { 
mConnectThread. cancel () 7 
mConnectThread=null; 


if (mConnectedThread !=null) { 
mConnectedThread. cancel () + 
mConnectedThread-null; 


if (mAcceptThread !-null) { 
mAcceptThread.cancel(); 
mAcceptThread-null; 


mConnectedThread-new ConnectedThread (socket) ; 
mConnectedThread. start (); 


Message msg-mHandler.obtainMessage (BluetoothChat.MESSAGE DEVICE NAME) ; 
Bundle bundle-new Bundle(); 

bundle.putString (BluetoothChat.DEVICE NAME, device.getName()) ; 
msg.setData (bundle) ; 

mHandler.sendMessage (msg) ; 


setState (STATE CONNECTED) ; 


// 停止 所 有 相关 线程 ， 设 当前 状态 为 NONE 
public synchronized void stop() { 


if (mConnectThread !=null) { 
mConnectThread. cancel (); 
mConnectThread=null; 

} 

if (mConnectedThread !-null) { 
mConnectedThread. cancel () ; 
mConnectedThread-null; 

) 

if (mAcceptThread !=null) { 
mAcceptThread.cancel(); 
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mAcceptThread-null; 


} 
setState (STATE NONE) ; 


// 在 STATE CONNECTED 状态 下 ， 调 用 mConnectedThread 里 的 write 方法 , SA byte 
public void write (byte[] out) ( 


ConnectedThread r; 


synchronized (this) { 
if (mState !=STATE CONNECTED) 
return; 
r-mConnectedThread; 


r.write (out) ; 


// 连接 失败 的 时 候 处 理 ， 通 知 ui, JEUL STATE LISTEN 状态 
private void connectionFailed() { 
setState (STATE_LISTEN) ; 


Message msg-mHandler.obtainMessage (BluetoothChat.MESSAGE TOAST) ; 
Bundle bundle-new Bundle(); 

bundle.putString (BluetoothChat.TOAST, "链接 不 到 设备 ") ; 
msg.setData (bundle) ; 

mHandler.sendMessage (msg) ; 


// 当 连 接 失 去 的 时 候 ， 设 为 STATE LISTEN 状态 并 通知 UI 
private void connectionLost () { 
setState (STATE LISTEN) ; 


Message msg=mHandler.obtainMessage (BluetoothChat.MESSAGE TOAST) ; 
Bundle bundle=new Bundle(); 

bundle.putString (BluetoothChat .7TOAST，" 设 备 链接 中 断 ") ; 
msg.setData (bundle) ; 

mHandler.sendMessage (msg) ; 


// 创建 监听 线程 ， 准 备 接受 新 连接 。 使 用 阻塞 方式 调用 BluetoothServerSocket.accept() 
Private class AcceptThread extends Thread { 


private final BluetoothServerSocket mmServerSocket; 


public AcceptThread() { 
BluetoothServerSocket tmp=null; 


try { 
tmp=mAdapter 
-listenUsingRfcommWithServiceRecord (NAME, MY UUID) ; 
} catch (IOException e) ( 
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// 双方 蓝牙 连接 后 一 直 运行 的 线程 。 构 造 函 数 中 设置 输入 输出 流 
// Run 方法 中 使 用 阻塞 模式 的 InputStream. read () 循环 读 取 输 入 流 ， 
// 然后 post 到 Ul 线程 中 更 新 聊天 消息 。 也 提供 了 write () 将 聊天 消息 写 入 输出 流传 输 至 对 方 ， 传 输 成 功 后 回 


BA UI 线程 。 最 后 cancel () 关闭 连接 的 socket 


private class ConnectedThread extends Thread { 
private final BluetoothSocket mmSocket; 
private final InputStream mmInStream; 
private final OutputStream mmOutStream; 


public ConnectedThread (BluetoothSocket socket) { 


mmSocket=socket; 
InputStream tmpIn=null; 
OutputStream tmpOut-null; 


try { 
tmpIn-socket.getInputStream(); 
tmpOut-socket.getOutputStream(); 
) catch (IOException e) { 


mmInStream-tmpIn; 
mmOutStream-tmpOut; 


public void run() { 


byte[] buffer-new byte[1024]; 
int bytes; 


while (true) { 
try { 


bytes-mmInStream.read (buffer) ; 


mHandler.obtainMessage (BluetoothChat.MESSAGE READ, bytes, 
-1, buffer) .sendToTarget(); 
) catch (IOException e) { 


connectionLost () ; 
break; 


public void write (byte[] buffer) { 


try { 
mmOutStream.write (buffer) ; 


mHandler.obtainMessage (BluetoothChat .MESSAGE WRITE, -1, -1, 
buffer) .sendToTarget (); 
} catch (IOException e) { 
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DeviceList 用 于 显示 蓝牙 设备 列表 ， 并 返回 蓝牙 设备 


package introduction.android.BluetoothChat; 


public void cancel () { 
try { 
mmSocket .close() 7 
) catch (IOException e) { 





import java.util.Set; 

import android.app.Activity; 

import android.bluetooth.BluetoothAdapter; 
import android.bluetooth.BluetoothDevice; 
import android.content.BroadcastReceiver; 
import android.content.Context; 

import android.content.Intent; 

import android.content.IntentFilter; 
import android.os.Bundle; 

import android.view.View; 

import android.view.Window; 

import android.view.View.OnClickListener; 
import android.widget.AdapterView; 

import android.widget.ArrayAdapter; 
import android.widget.Button; 

import android.widget.ListView; 

import android.widget.TextView; 

import android.widget.AdapterView.OnItemClickListener; 


public class DeviceList extends Activity { 


public static String EXTRA DEVICE ADDRESS-"device address"; 


private BluetoothAdapter mBtAdapter; 


private ArrayAdapter<String>mPairedDevicesArrayAdapter; 


private ArrayAdapter<String>mNewDevicesArrayAdapter; 


@Override 


protected void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState) ; 


requestWindowFeature (Window.FEATURE INDETERMINATE PROGRESS) ; 


setContentView (R.layout.device list) ; 


setResult (Activity.RESULT CANCELED) ; 


Button scanButton- (Button) findViewById (R.id.button scan) ; 


scanButton.setOnClickListener (new OnClickListener () { 


public void onClick (View v) { 


A. DeviceList java 的 代码 如 下 : 
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doDiscovery():; 
v.setVisibility (View.GONE) ; 


D: 


mPairedDevicesArrayAdapter-new ArrayAdapter<String> (this, 
R.layout.device name) ; 

mNewDevicesArrayAdapter=new ArrayAdapter<String> (this, 
R.layout.device name) ; 


ListView pairedListView= (ListView) findViewById (R.id.paired devices) ; 
pairedListView.setAdapter (mPairedDevicesArrayAdapter) ; 
pairedListView.setOnItemClickListener (mDeviceClickListener) ; 


ListView newDevicesListView= (ListView) findViewById (R.id.new devices) ; 
newDevicesListView.setAdapter (mNewDevicesArrayAdapter) ; 
newDevicesListView.setOnItemClickListener (mDeviceClickListener) ; 


IntentFilter filter-new IntentFilter (BluetoothDevice.ACTION FOUND) ; 
this.registerReceiver (mReceiver, filter) ; 


filter-new IntentFilter (BluetoothAdapter.ACTION DISCOVERY FINISHED) [i 
this.registerReceiver (mReceiver, filter) ; 


mBtAdapter-BluetoothAdapter.getDefaultAdapter(); 
Set«BluetoothDevice»pairedDevices-mBtAdapter.getBondedDevices(); 


if (pairedDevices.size()>0) ( 
findViewById (R.id.title paired devices) .setVisibility (View.VISIBLE) ; 
for (BluetoothDevice device : pairedDevices) { 
mPairedDevicesArrayAdapter.add (device.getName()+"\n" 
+device.getAddress()) ; 
} 
} else { 
String noDevices-getResources().getText (R.string.none paired) 
-toString(): 
mPairedDevicesArrayAdapter.add (noDevices) ; 


@Override 
protected void onDestroy() { 
super.onDestroy ()7 
if (mBtAdapter !-null) { 
mBtAdapter.cancelDiscovery():; 


this.unregisterReceiver (mReceiver) ; 


private void doDiscovery()í 


setProgressBarIndeterminateVisibility (true) ; 
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setTitle (R.string.scanning) ; 
findViewById (R.id.title new devices) .setVisibility (View.VISIBLE) ; 


if (mBtAdapter.isDiscovering()) ( 
mBtAdapter.cancelDiscovery(): 


mBtAdapter.startDiscovery(); 


private OnItemClickListener mDeviceClickListener-new OnItemClickListener () { 
public void onItemClick (AdapterView<?>av, View v, int arg2, long arg3) { 


mBtAdapter.cancelDiscovery(); 


String info= ((TextView) v) .getText().toString(); 
String address-info.substring (info.length()- 17) ; 


Intent intent=new Intent (); 
intent.putExtra (EXTRA DEVICE ADDRESS, address) ; 


setResult (Activity.RESULT OK, intent) ; 
finish(); 


private final BroadcastReceiver mReceiver-new BroadcastReceiver()( 
@Override 
public void onReceive (Context context, Intent intent) { 
String action=intent.getAction(); 


if (BluetoothDevice.ACTION FOUND.equals (action)) { 


BluetoothDevice device=intent 
-getParcelableExtra (BluetoothDevice.EXTRA DEVICE) ; 


if (device.getBondState() !=BluetoothDevice.BOND BONDED) { 
mNewDevicesArrayAdapter.add (device.getName()+"\n" 
+device.getAddress()) ; 


} else if (BluetoothAdapter.ACTION DISCOVERY FINISHED 

equals (action)) { 

setProgressBarIndeterminateVisibility (false) ; 

setTitle (R.string.select device) ; 

if (mNewDevicesArrayAdapter.getCount ()==0) { 
String noDevices-getResources().getText ( 

R.string.none found) .toString(); 

mNewDevicesArrayAdapter.add (noDevices) ; 
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8.4 WIFI 通信 


8.4.1 WIFI 简介 


WIFI (Wireless Fidelity) 是 一 种 可 以 将 个 人 电脑 、 手 持 设 备 〈 如 PDA、 手 机 ) 等 终端 以 无 线 
方式 互相 连接 的 技术 。WIFI 是 由 一 个 名 为 “无 线 以 太 网 相 容 联盟 ”(Wireless Ethernet Compatibility 
Alliance, WECA) 的 组 织 所 发 布 的 业界 术语 ， 中 文 译 为 “无 线 相 容 认证 ”。 

随 着 通信 技术 的 发 展 ， 以 及 IEEE 802.11a. IEEE 802.11g 等 标准 的 出 现 ， 现 在 IEEE 802.11 标 
准 已 被 统称 作 WIFI. 1997 年 ,IEEE 802.11 第 一 个 版 本 发 表 , 其 中 定义 了 介质 访问 接 入 控制 层 (MAC 
层 ) 和 物理 层 。 物理 层 定义 了 工作 在 2.4GHz 的 ISM 频段 上 的 两 种 无 线 调频 方式 和 一 种 红外 传输 方 
式 ， 总 数据 传输 速率 设计 为 2Mbit/s。 两 个 设备 之 间 的 通信 可 以 自由 直接 (ad hoc) 的 方式 进行 ,也 
可 以 在 基站 (Base Station, BS) 或 者 访问 点 (Access Point, AP) 的 协调 下 进行 。1999 年 加 上 了 两 
个 补充 版 本 : 802.11a 定义 了 一 个 在 SGHz 的 ISM 频段 上 的 数据 传输 速率 可 达 54Mbit/s 的 物理 层 ， 
802.11b 定义 了 一 个 在 2.4GHz 的 ISM 频段 上 的 数据 传输 速率 高 达 11Mbit/s 的 物理 层 。WIFI 的 正式 
名 称 是 “IEEE802.11b”。 

WIFI 是 一 种 帮助 用 户 访 问 电子 邮件 、Web 和 流 式 媒体 的 互联 网 技术 ， 它 为 用 户 提供 了 无 线 的 
宽带 互联 网 访问 。 同 时 ， 它 也 是 在 家 里 、 办 公 室 或 在 旅途 中 比较 快速 、 便 捷 的 上 网 途径 。WIFI 在 
掌上 设备 上 应 用 得 越 来 越 广泛 , 而 智能 手机 就 是 其 中 一 分 子 。 与 早 前 应 用 于 手机 上 的 蓝牙 技术 不 同 ， 
WIFI 具有 更 大 的 覆盖 范围 和 更 高 的 传输 速率 ， 因 此 WIFI 手机 成 为 目前 移动 通信 业界 的 时 尚 潮 流 。 
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842 ”WIFI 实例 Witibemo 


Android SDK 提供 了 WIFI 开发 的 相关 API， 被 保存 在 
android.net.wifi 和 android.net.wifi.p2p 包 下 。 借 助 于 Android SDK 
提供 的 相关 开发 类 , 可 以 方便 地 在 Android 系统 的 手机 上 开发 基 
于 WIFI 的 应 用 程序 。 

实例 WIFIDemo 演 示 了 使 用 WIFI 进 行 连接 设备 搜索 并 获取 
相应 信息 的 过 程 ， 运 行 效果 如 图 8.9 所 示 。 

实例 WIFIDemo 中 所 使 用 的 布局 文件 main.xml 的 内 容 如 
T: 

<?xml version-"1.0" encoding-"utf-8"?» 

<ScrollView 
xmlns:android-"http://schemas.android.com/apk/res/android" 图 8.9 实例 WIFIDemo 的 运行 效果 

android: id="@tid/mScrollView" i 
android:layout_width="fill parent" 
android:layout_height="wrap content" android:scrollbars="vertical"> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android: layout_width="fill parent" 
android: layout_height="fill parent" 





android: orientation="vertical"> 


第 8 章 网 络 编程 


297 





<LinearLayout 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:orientation-"horizontal"» 


«Button 
android: id="@+tid/open bt" 
android: layout_width="wrap content" 
android:layout height-"wrap content" 
android:text-"//7f wifi" /> 


«Button 
android:id-"8*id/close bt" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text- "AX wifi" /> 





«Button 
android:id-"&*id/check bt" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text="## wifi" /> 





<Button 
android: id="@tid/search_bt" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android:text="A7# wifi" /> 
</LinearLayout> 
<TextView 
android: id="@tid/text" 
android: layout_width="wrap content" 
android: layout_height="wrap content" 
android:text="null"/> 
</LinearLayout> 
</ScrollView> 





例 WIFIDemo 中 AndroidManifest.xml 文件 的 代码 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"sie.android.wifi" 
android:versionCode-"]" 
android:versionName-"].0"» 


<uses-sdk android:minSdkVersion-"10" /> 

«uses-permission android:name-"android.permission.CHANGE NETWORK STATE" 
android.permission.CHANGE WIFI STATE" /» 
«uses-permission android:name-"android.permission.ACCESS NETWORK STATE" 
«uses-permission android:name-"android.permission.ACCESS WIFI STATE" /> 
«application 


«uses-permission android:namé 





android:icon-"édrawable/ic launcher" 
android:label-"8string/app name"> 
«activity 


/> 


/> 


298 


| Android 7 应 用 程序 开发 教程 





android:name="introduction. android. wifi.WifiDemoActivity" 
android: label="@string/app name"> 
<intent-filter> 


<action android:name-"android.intent.action.MAIN" /> 


«category android:name="android. intent.category.LAUNCHER" /> 
</intent-filter> 


</activity> 
</application> 
</manifest> 


实例 WIFIDemo 中 主 Activity 文件 WifiDemoActivity java 的 代码 如 下 : 


package introduction.android.wifi; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


public 


java.util.List; 
android.R.string; 
android.app.Activity; 
android.content.Context; 
android.net.wifi.ScanResult; 
android.net.wifi.WifilInfo; 
android.net.wifi.WifiManager; 
android.os.Bundle; 
android.view.View; 
android.view.View.OnClickListener; 
android.widget.Button; 
android.widget.ScrollView; 
android.widget.TextView; 
android.widget.Toast; 


class WifiDemoActivity extends Activity ( 


private Button open bt, close bt, check bt, search bt; 
private TextView textView; 

private WifiManager wifiManager; 

private WifiInfo wifiInfo; 

private ScrollView scrollView; 

private List WifiConfiguration; 

private ScanResult scanResult; 

private List<ScanResult>WifiList; 

private StringBuffer stringBuffer-new StringBuffer(); 


/** Called when the activity is first created. */ 


public void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


scrollView- (ScrollView) findViewById (R.id.mScrollView) ; 
open bt- (Button) findViewById (R.id.open bt) ; 

close bt- (Button) findViewById (R.id.close bt) ; 

check bt- (Button) findViewById (R.id.check bt) ; 

search bt= (Button) findViewById (R.id.search bt) ; 
textView- (TextView) findViewById (R.id.text) ; 


open bt.setOnClickListener (new open btListener()) ; 
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close bt.setOnClickListener (new close btListener()) ; 
check bt.setOnClickListener (new check btListener()) ; 
search bt.setOnClickListener (new search btListener()) ; 
$ 
class search btListener implements OnClickListener { 
public void onClick (View v) ( 
// TODO Auto-generated method stub 
wifiManager.startScan(); 
WifiList-wifiManager.getScanResults(); 
wifilnfo-wifiManager.getConnectionInfo(); 
if (stringBuffer !=null) { 
stringBuffer-new StringBuffer(); 
} 
stringBuffer-stringBuffer.append ("Wifi 4") .append (" ") .append ("Wifi Hh 
tk") .append (" ") .append ("Wifi 频率 ") .append (" ") .append ("Wifi 信号 ") .append ("An") ; 
if (WifiList !=null) ( 
for (int i-0; i«WifiList.size(); i++) ( 
scanResult=WifiList.get (i) ; 
stringBuffer-stringBuffer.append (scanResult.SSID) .append (" ") 


-append (scanResult.BSSID) .append (" ") 
.append (scanResult.frequency) .append (" ") 
.append (scanResult.level) .append ("An") ; 


textView.setText (stringBuffer.toString()) ; 
) 
stringBuffer-stringBuffer.append 
("----------------------------------------------- ") .append ("An") ; 
textView.setText (stringBuffer.toString()) ; 
stringBuffer-stringBuffer.append (" 当 前 Wifi—BSSID") .append (": 
") .append (wifiInfo.getBSSID()) .append ("An") 
.append ("f Wifi—HiddenSSID") .append (": ") .append 
(wifilnfo.getHiddenSSID()) .append ("An") 
.append ("当前 Wifi 一 IpAddress") .append (": ") .append 
(wifiInfo.getIpAddress()) .append ("An") 
.append ("当前 Wifi 一 LinkSpeed") .append (": ") .append 
(wifilnfo.getLinkSpeed()) .append ("An") 
.append ("f Wifi—MacAddress") .append (": ") .append 
(wifilnfo.getMacAddress ()) .append ("An") 
-append ("当前 Wifi 一 Network ID") .append (": ") .append 
(ifilnfo.getNetworkId()) .append ("An") 
.append ("当前 Wifi 一 RSSI") .append (": ") .append 
(wifiInfo.getRssi()) .append ("\n") 
.append ("当前 Wifi 一 SSID") .append (": ") .append 
(wifilInfo.getSSID()) .append ("An") 
.append 
[une T E UD E E ") „append ("\n") 


„append ("全 部 打印 出 关于 本 机 wifi 信息 ") .append (": ") .append 


(wifiInfo.toString()) ; 


textView.setText (stringBuffer.toString()) ; 
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String temp-null; 
switch (wifiManager.getWifiState()) { 


case 0: 
temp-"Wifi 正在 关闭 ING"; 
break; 

case 1: 
temp-"Wifi 已 经 关闭 "7 
break; 

case 2: 
temp-"Wifi 正在 打开 ING"; 
break; 

case 3: 
temp-"Wifi 已 经 打开 "; 
break; 

default: 

break; 


$ 


return temp; 


} 


8.4.3 WIFI Direct 


WIFI Direct 意 为 通过 WIFI 直接 建立 连接 。 2010 年 10 H, WIFI 联盟 发 布 WIFI Direct 白皮书 ， 
白皮书 中 介绍 了 关于 这 种 技术 的 基本 信息 、 特 点 和 功能 。WIFI Direct 标准 是 指 允许 无 线 网 络 中 的 
设备 无 须 通过 无 线路 由 器 即 可 相互 连接 。 这 种 标准 支持 WIFI 的 无 线 设备 像 蓝牙 那样 以 点 对 点 的 形 
式 互 连 ， 但 是 在 传输 速度 与 传输 距离 方面 都 比 蓝牙 有 大 幅 提升 。 

WIFI Direct 设备 是 支持 对 等 连接 的 设备 , 这 种 设备 既 支 持 基础 设施 网 络 , 也 支持 P2P (Peer To 
Peer， 点 对 点 ) 连接 。 

Android N 提供 了 WIFI Direct 用 于 WIFI 的 直接 连接 。 借 助 于 WIFI Direct API， 支 持 WIFI 功 
能 的 Android N 系统 的 手机 可 以 直接 通过 WIFI 连接 ， 而 不 需要 经 过 接 入 点 。 

WIFI Direct 提供 WifiP2pManager 类 ， 其 功能 主要 分 为 以 下 三 部 分 : 

© = WifiP2pManager 类 提供 相关 API 用 于 发 现 可 连接 的 点 ， 并 进行 请 求 和 建立 连接 。 

e 每 个 WifiP2pManager 的 方法 都 要 求 传 入 对 应 的 监听 器 ， 用 于 监听 对 该 方法 是 否 成 功 运行 。 

o ” 当 检 测 到 特定 事件 ， 如 可 连接 的 点 减少 或 者 发 现 了 新 的 可 连接 的 点 ，WIFI Direct 框架 会 通过 

Intent 通知 用 户 。 


一 般 情况 下 ,这 三 部 分 功能 是 共同 使 用 的 。 例如， 可 以 通过 WifiP2pManager.ActionListener 调 
用 discoverPeers() ， 以 便当 建立 连接 时 ， 可 以 通过 ActionListener.onSuccess() 和 
ActionListener.onFailure() 方 法 获得 相应 结果 的 通知 。 当 discoverPeers0 方 法 探测 到 发 现 列 表 中 的 点 
发 生 改变 时 ， 一 个 包含 WIFI P2P PEERS CHANGED ACTION 信息 的 Intent 会 被 广播 。 
WifiP2pManager 提供 的 方法 如 表 8.5 所 示 。 
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表 8.5 WifiP2pManager 的 方法 






































方法 名 描述 

initialize() 为 应 用 程序 注册 WIFI 框架 。 该 方法 必须 在 任何 其 他 WIFI Direct 方法 被 调用 前 调用 
connect() 与 具有 指定 配置 的 WIFI 设备 建立 点 对 点 连接 

cancelConnect() 断 开 连接 

requestConnectInfo() 获取 设备 的 连接 信息 

createGroup() 以 当前 设备 为 拥有 者 创建 一 个 点 对 点 组 

removeGroup() 删除 当前 的 点 对 点 组 

requestGroupInfo() 获取 点 对 点 组 的 信息 

discoverPeers() 初始 化 发 现 对 等 点 设备 服务 

requestPeers() 获取 当前 已 发 现 的 对 等 点 设备 列表 





WifiP2pManager 支持 的 监听 器 如 表 8.6 所 示 。 
表 8.6 WifiP2pManager 支持 的 监听 器 
监听 器 接口 相关 动作 


connect(), cancelConnect(), createGroup(), removeGroup(), 








WifiP2pManager.ActionListener aid discóverfeers) 
WifiP2pManager.ChannelListener initialize() 
WifiP2pManager.ConnectionInfoListener requestConnectInfo() 
WifiP2pManager.GroupInfoListener requestGroupInfo() 
WifiP2pManager.PeerListListener requestPeers() 


WifiP2pManager 支持 的 Intent 如 表 8.7 所 示 。 


表 8.7 WifiP2pManager 支持 的 Intent 







Intent 
WIFI P2P CONNECTION CHANGED ACTION | “4 WIFI 设备 的 连接 状态 改变 时 广播 
当 discoverPeers() 方 法 被 调用 时 广播 。 通 过 该 Intent. 可 以 获取 
到 最 新 的 对 等 点 设备 的 列表 

WIFI P2P STATE CHANGED ACTION 当 WIFI Direct 功能 在 设备 上 被 打开 或 者 关闭 时 广播 

WIFI P2P THIS DEVICE CHANGED ACTION | 当 WIFI 设 备 的 具体 信息 改变 时 广播 ， 例 如 设备 的 名 字 改 变 时 


WIFI P2P PEERS CHANGED ACTION 











8.4.4 创建 WIFI Direct 应 用 程序 的 步骤 


创建 一 个 WIFI Direct 应 用 程序 ， 包 括 发 现 连接 点 、 请 求 连 接 、 建 立 连接 、 发 送 数据 ， 以 及 建 
立 对 该 应 用 程序 广播 的 Intent 进行 接收 的 BroadcastReceiver， 需 要 经 过 以 下 步骤 。 

CXX0) 创建 BroadcastReceiver， 需 要 注意 的 是 ， 要 在 BroadcastReceiver 的 构造 方法 中 传 入 
WifiP2pManager. WifiP2pManager.Channel 以 及 注册 该 BroadcastReceiver 的 Activity 的 对 象 ， 以 便 在 
BroadcastReceiver 中 访问 WIFI 硬件 设备 并 对 Activity 进行 更 新 。 


创建 BroadcastReceiver 的 代码 如 下 : 
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public class WiFiDirectBroadcastReceiver extends BroadcastReceiver { 
private WifiP2pManager manager; 
private Channel channel; 


private MyWiFiActivity activity; 


public WiFiDirectBroadcastReceiver (WifiP2pManager manager, Channel channel, 
MyWifiActivity activity) { 
super (); 
this .manager=manager; 
this.channel=channel; 
this.activity=activity; 


@Override 
public void onReceive (Context context, Intent intent) { 
String action=intent.getAction(); 


if (WifiP2pManager.WIFI P2P STATE CHANGED ACTION.equals (action)) { 
// 检测 WIFI 功能 是 否 被 打开 

} else if (WifiP2pManager.WIFI P2P PEERS CHANGED ACTION.equals (action)) { 
// 获得 当前 可 用 连接 点 的 列表 

} else if (WifiP2pManager.WIFI P2P CONNECTION CHANGED ACTION.equals (action)) { 
// 建立 或 者 断 开 连 接 

} else if (WifiP2pManager.WIFI P2P THIS DEVICE CHANGED ACTION.equals (action)) { 
// 当前 设备 的 WIFI 状态 发 生变 化 


} 


E 初始 化 操作 。 
(1) 修改 AndroidManifestxml 文件 ， 指 定 支持 WIFI Direct 的 Android SDK 的 最 小 版 本 并 
加 使 用 WIFI Direct 的 相应 权限 ， 代 码 如 下 : 


<uses-sdk android:minSdkVersion="14" /> 





<uses-permission android:name-"android.permission.ACCESS WIFI STATE" /> 
<uses-permission android:name-"android.permission.CHANGE WIFI STATE" /> 
<uses-permission android:name-"android.permission.CHANGE NETWORK STATE" /> 
<uses-permission android:name-"android.permission.INTERNET" /> 
<uses-permission android:name-"android.permission.ACCESS NETWORK STATE" /> 


(2) 确认 当前 设备 是 否 支持 并 且 打 开 了 WIFI Direct 功能 。 相 关 代 码 应 
BroadcastReceiver 的 onReceive() 方 法 中 。 实 例 代 码 如 下 : 





被 放 在 


public void onReceive (Context context, Intent intent) { 
String action=intent.getAction(); 
if (WifiP2pManager.WIFI P2P STATE CHANGED ACTION.equals (action)) { 
int state-intent.getIntExtra (WifiP2pManager.EXTRA WIFI STATE, -1) ; 
if (state--WifiP2pManager.WIFI P2P STATE ENABLED) { 
// Wifi Direct is enabled 
) eise ( 
// Wi-Fi Direct is not enabled 


304 | Android 7 应 用 程序 开发 教程 








(3) 在 Activity 的 onCreate0 方 法 中 创建 WifiP2pManager 和 Channel XR, Jf OA 
BroadcastReceiver 对 象 ， 代 码 如 下 : 


WifiP2pManager mManager; 
Channel mChannel; 


D: 


BroadcastReceiver mReceiver; 

@Override 

protected void onCreate (Bundle savedInstanceState) { 
mManager= (WifiP2pManager) getSystemService (Context.WIFI P2P SERVICE) ; 
mChannel=mManager.initialize (this, getMainLooper(), null) ; 
mReceiver-new WiFiDirectBroadcastReceiver (manager, channel, this) ; 


(4) 创建 BroadcastReceiver 要 使 用 的 IntentFilter 对 象 ， 代 码 如 下 : 


IntentFilter mIntentFilter; 

@Override 

protected void onCreate (Bundle savedInstanceState) { 
mIntentFilter-new IntentFilter(); 
mIntentFilter.addAction (WifiP2pManager.WIFI P2P STATE CHANGED ACTION) ; 
mIntentFilter.addAction (WifiP2pManager.WIFI P2P PEERS CHANGED ACTION) ; 
mIntentFilter.addAction (WifiP2pManager.WIFI P2P CONNECTION CHANGED ACTION) ; 
mIntentFilter.addAction (WifiP2pManager.WIFI P2P THIS DEVICE CHANGED ACTION) ; 


(5) 在 Activity 的 onResume() 方 法 中 注册 BroadcastReceiver X1 $$, 在 onPause0 方 法 中 注销 对 
象 ， 代 码 如 下 : 


@Override 
protected void onResume () { 
super.onResume () 7 
registerReceiver (mReceiver, mIntentFilter) ; 
) 
/* unregister the broadcast receiver */ 
@Override 
protected void onPause() { 
super.onPause(); 
unregisterReceiver (mReceiver) ; 
} 


€I 使 用 WifiP2pManagerdiscoverPeers0 方 法 获取 可 以 连接 点 的 列表 。 示 例 代码 如 下 : 


manager.discoverPeers (channel, new WifiP2pManager.ActionListener() { 
@override 
public void onSuccess() { 
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@Override 


public void onFailure (int reasonCode) { 


ih 
ps 
若 成 功 搜寻 到 可 以 连接 的 点 ， 则 WIFI Direct 系统 框架 会 广播 一 个 带 有 WIFI P2P_ 
PEERS CHANGED ACTION 信息 的 Intent, i% Intent 会 被 之 前 定义 的 BoradcastReceiver 接收 ， 并 
获得 可 以 连接 点 的 列表 。 示 例 代码 如 下 : 


PeerListListener myPeerListListener; 





if (WifiP2pManager.WIFI P2P PEERS CHANGED ACTION.equals (action)) { 
if (manager !-null) ( 


manager.requestPeers (channel, myPeerListListener) ; 


) 


€o 通过 WifiP2pManager.connect0 方 法 可 以 与 列表 中 的 某 个 连接 点 设备 建立 连接 ， 该 方 
法 通过 WifiP2pConfig 对 象 获 得 连接 设备 的 相关 信息 。 示 例 代码 如 下 : 

WifiP2pDevice device; 

WifiP2pConfig config-new WifiP2pConfig():; 

config.deviceAddress-device.deviceAddress; 

manager.connect (channel, config, new ActionListener()( 


@Override 
public void onSuccess() { 
//success logic 


} 


@Override 
public void onFailure (int reason) { 
//failure logic 
} 
DOES 
GES 连接 建立 后 ， 就 可 以 用 两 个 设备 直接 通过 Socket 进行 数据 传输 。 其 传输 过 程 与 之 前 
讲解 的 Socket 通信 完全 相同 ， 基 本 步骤 如 下 : 


COD 在 其 中 一 个 设备 上 建立 ServerSocket 对 象 ， 监 听 特 定 端口 ， 并 堵塞 应 用 程序 ， 直 到 有 连 


(2) 在 另 一 个 设备 上 建立 Socket 对 象 ， 通 过 IP 地 址 和 端口 向 ServerSocket 发 出 连接 请 求 。 
(3) ServerSocket 监听 到 连接 请 求 后 ， 调 用 accept( 方 法 建立 连接 。 
(4) 连接 建立 后 ，Socket 对 象 可 以 通过 字 节 流 在 两 个 设备 间 直 接 进 行 数据 传递 。 
下 面 的 示例 代码 演示 了 通过 ServerSocket 和 Socket 在 客户 端 和 服务 器 间 直 接 传递 JPG. 图 像 的 
服务 器 代码 如 下 : 


public static class FileServerAsyncTask extends AsyncTask { 
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客户 端的 相关 代码 如 下 : 
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Socket socket=new Socket () 
byte buf[]=new byte[1024]; 
try { 

//8N Socket 对 象 ， 并 请 求 连 接 


Socket.bind (null) ; 
socket.connect ((new InetSocketAddress (host, port)) , 500) ; 


// 连 接 建 立成 功 ， 开 始 传输 数据 

OutputStream outputStream=socket .getOutputStream () ; 
ContentResolver cr=context.getContentResolver(); 
InputStream inputStream-null; 
inputStream-cr.openInputStream (Uri.parse ("path/to/picture.jpg")) ; 
while ((len=inputStream.read (buf)) !=-1) { 

outputStream.write (buf, 0, len) ; 

} 
outputStream.close(); 
inputStream.close(); 

} catch (FileNotFoundException e) ( 
//catch logic 

) catch (IOException e) ( 
//catch logic 

) 


// 关 闭 连接 
finally { 
if (socket !=null) { 
if (socket.isConnected()) { 
try { 
socket.close(); 
} catch (IOException e) { 
//catch logic 
T 


8.4.5 WIFI Direct 编程 实例 


实例 WIFIDirectDemo 改编 自 Android SDK 提供 的 实例 ， 演 示 了 通过 WIFI 搜寻 连接 点 ， 建 立 
连接 ， 并 进行 数据 传输 的 过 程 。 

该 实例 包含 5 个 类 ， 说 明说 下 : 
WIFIDirectDemoActivity: 用 于 注册 BroadcastReceiver， 处 理 UI， 并 管理 连接 点 的 生命 周期 。 
WiFiDirectBroadcastReceiver: 用 于 接收 与 WIFI Direct 功能 相关 的 Intent, 
DeviceListFragment: 用 于 显示 可 以 连接 点 列表 及 其 状态 。 
FileTransferService: 通过 TCP 协议 在 客户 端 与 服务 器 之 间 进 行文 件 传输 的 IntentService。 
IntentService: Sevice 的 子 类 ， 用 于 处 理 异 步 请 求 。 


该 实例 的 运行 效果 如 图 8.10 所 示 。 
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WiFi D 





图 8.10 实例 WIFIDirectDemo 的 运行 效果 


WIFIDirectDemo 的 AndroidManifest.xml 文件 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package="introduction.android.wifidirectdemo" 
android: versionCode="1" android: versionName="1.0"> 


<uses-sdk android:minSdkVersion="14" /> 

<uses-permission android:name="android.permission.ACCESS WIFI STATE" /> 
<uses-permission android:name="android.permission.CHANGE WIFI STATE" /> 
<uses-permission android:name="android.permission.CHANGE NETWORK STATE" /> 
<uses-permission android:name="android.permission. INTERNET" /> 
<uses-permission android:name="android.permission.ACCESS NETWORK STATE" /> 
«uses-permission android:name-"android.permission.READ PHONE STATE" /> 
<uses-permission android:name-"android.permission.WRITE EXTERNAL STORAGE" /> 


«!-- Market filtering --> 
«uses-feature android:name-"android.hardware.wifi.direct" android:required-"true"/» 


«application 
android: icon="@drawable/ic launcher" 
android: label="@string/app name" 
android: theme="@android:style/Theme.Holo"> 








<activity 
android: name=".WIFIDirectDemoActivity" 
android: label="@string/app name" android: launchMode="singleTask"> 





<intent-filter> 
<action 
android:name-"android.intent.action.MAIN" /> 
<category 
android:name="android. intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 


第 8 章 网 络 编程 


| 


309 





<!-- Used for transferring files after a successful connection --> 


<service android:enabled-"true" android:name-".FileTransferService" /> 


</application> 
</manifest> 


WIFIDirectDemoActivity java 的 代码 如 下 : 


package introduction.android.wifidirectdemo; 


import introduction.android.wifidirectdemo.DeviceListFragment.DeviceActionListener; 


import android.app.Activity; 

import android.content.BroadcastReceiver; 
import android.content.Context; 

import android.content.Intent; 

import android.content.IntentFilter; 

import android.net.wifi.p2p.WifiP2pConfig; 
import android.net.wifi.p2p.WifiP2pDevice; 
import android.net.wifi.p2p.WifiP2pManager; 


import android.net.wifi.p2p.WifiP2pManager.ActionListener; 


import android.net.wifi.p2p.WifiP2pManager.Channel; 


import android.net.wifi.p2p.WifiP2pManager.ChannelListener; 


import android.os.Bundle; 

import android.provider.Settings; 
import android.util.Log; 

import android.view.Menu; 

import android.view.MenuInflater; 
import android.view.MenuItem; 
import android.view.View; 

import android.widget.Toast; 


public class WIFIDirectDemoActivity extends Activity implements ChannelListener, 


DeviceActionListener { 


public static final String TAG-"wifidirectdemo"; 
private WifiP2pManager manager; 

private boolean isWifiP2pEnabled-false; 

private boolean retryChannel-false; 


private final IntentFilter intentFilter-new IntentFilter(); 


private Channel channel; 
private BroadcastReceiver receiver-null; 


public void setIsWifiP2pEnabled (boolean isWifiP2pEnabled) ( 


this.isWifiP2pEnabled-isWifiP2pEnabled; 


public void onCreate (Bundle savedInstanceState) ( 


super.onCreate (savedInstanceState) ; 


setContentView (R.layout.main) ; 


// add necessary intent values to be matched. 
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intentFilter.addAction (WifiP2pManager.WIFI P2P STATE CHANGED ACTION) ; 
intentFilter.addAction (WifiP2pManager.WIFI P2P PEERS CHANGED ACTION) ; 
intentFilter.addAction (WifiP2pManager.WIFI P2P CONNECTION CHANGED ACTION) ; 
intentFilter.addAction (WifiP2pManager.WIFI P2P THIS DEVICE CHANGED ACTION) ; 


manager- (WifiP2pManager) getSystemService (Context.WIFI P2P SERVICE) ; 
channel-manager.initialize (this, getMainLooper(), null) ; 


/** register the BroadcastReceiver with the intent values to be matched */ 


public void onResume() { 
super.onResume () ; 
receiver=new WiFiDirectBroadcastReceiver (manager, channel, this) ; 
registerReceiver (receiver, intentFilter) ; 


public void onPause() { 
super.onPause () 7 
unregisterReceiver (receiver) ; 


[** 
* Remove all peers and clear all fields. This is called on 
* BroadcastReceiver receiving a state change event. 
E 
public void resetData() { 
DeviceListFragment fragmentList- (DeviceListFragment) getFragmentManager() 
-findFragmentById (R.id.frag list) ; 
DeviceDetailFragmentl fragmentDetails- (DeviceDetailFragmentl) getFragmentManager () 
-findFragmentById (R.id.frag detail) ; 
if (fragmentList !-null) ( 
fragmentList.clearPeers(); 


} 
if (fragmentDetails !=null) { 


fragmentDetails.resetViews(); 


public boolean onCreateOptionsMenu (Menu menu) ( 
MenuInflater inflater-getMenuInflater(); 
inflater.inflate (R.menu.action items, menu) ; 
return true; 


public boolean onOptionsItemSelected (MenuItem item) { 
switch (item.getItemId()) { 
case R.id.atn direct enable: 
if (manager !-null && channel !-null) ( 
startActivity (new Intent (Settings.ACTION WIRELESS SETTINGS)) ; 
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public void onFailure (int reasonCode) { 
Toast .makeText (WIFIDirectDemoActivity.this, 
"Connect abort request failed. Reason Code: "+reasonCode, 
Toast.LENGTH SHORT) .show(); 


) 


WiFiDirectBroadcastReceiver java 的 代码 如 下 : 


package introduction.android.wifidirectdemo; 


import android.content.BroadcastReceiver; 

import android.content.Context; 

import android.content.Intent; 

import android.net.NetworkInfo; 

import android.net.wifi.p2p.WifiP2pDevice; 

import android.net.wifi.p2p.WifiP2pManager; 

import android.net.wifi.p2p.WifiP2pManager.Channel; 

import android.net.wifi.p2p.WifiP2pManager.PeerListListener; 

import android.util.Log; 

public class WiFiDirectBroadcastReceiver extends BroadcastReceiver ( 


private WifiP2pManager manager; 
private Channel channel; 
private WIFIDirectDemoActivity activity; 
public WiFiDirectBroadcastReceiver (WifiP2pManager manager, Channel channel, 
WIFIDirectDemoActivity wifiDirectDemoActivity) { 
super(); 
this.manager-manager; 
this.channel-channel; 
this.activity-wifiDirectDemoActivity; 
) 
@Override 
public void onReceive (Context context, Intent intent) { 
String action-intent.getAction(); 
if (WifiP2pManager.WIFI P2P STATE CHANGED ACTION.equals (action)) ( 


// UI update to indicate wifi p2p status. 
int state-intent.getIntExtra (WifiP2pManager.EXTRA WIFI STATE, -1) ; 
if (state--WifiP2pManager.WIFI P2P STATE ENABLED) { 
// Wifi Direct mode is enabled 
activity.setIsWifiP2pEnabled (true) ; 
} else { 
activity.setIsWifiP2pEnabled (false) ; 
activity.resetData(); 


} 
Log.d (WIFIDirectDemoActivity.TAG, "P2P state changed - "+state) ; 


) else if (WifiP2pManager.WIFI P2P PEERS CHANGED ACTION.equals (action)) { 


// request available peers from the wifi p2p manager. This is an 


314 


| Android 7 应 用 程序 开发 教程 





// asynchronous call and the calling activity is notified with a 
// callback on PeerListListener.onPeersAvailable() 
if (manager !=null) { 
manager. requestPeers (channel, (PeerListListener) activity. getFragmentManager () 
-findFragmentById (R.id.frag list)) ; 
$ 
Log.d (WIFIDirectDemoActivity.TAG, "P2P peers changed") ; 
) else if (WifiP2pManager.WIFI P2P CONNECTION CHANGED ACTION.equals (action)) { 


if (manager--null) ( 
return; 


NetworkInfo networkInfo- (NetworkInfo) intent 
-getParcelableExtra (WifiP2pManager.EXTRA NETWORK INFO) ; 


if (networkInfo.isConnected()) { 
// we are connected with the other device, request connection 
// info to find group owner IP 
DeviceDetailFragmentl fragment- (DeviceDetailFragmentl) activity 
-getFragmentManager().findFragmentById (R.id.frag detail) ; 
manager.requestConnectionInfo (channel, fragment) ; 
} else { 
// It's a disconnect 
activity. resetData(); 
2 
) else if (WifiP2pManager.WIFI P2P THIS DEVICE CHANGED ACTION.equals (action) { 
DeviceListFragment fragment= (DeviceListFragment) activity.getFragmentManager () 
-findFragmentById (R.id.frag list) ; 
fragment.updateThisDevice ((WifiP2pDevice) intent.getParcelableExtra ( 
WifiP2pManager.EXTRA WIFI P2P DEVICE)) ; 


DeviceListFragment.java 的 代码 如 下 : 


package introduction.android.wifidirectdemo; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


android.app.ListFragment; 
android.app.ProgressDialog; 
android.content.Context; 
android.content.DialogInterface; 
android.net.wifi.p2p.WifiP2pConfig; 
android.net.wifi.p2p.WifiP2pDevice; 
android.net.wifi.p2p.WifiP2pDeviceList; 
android.net.wifi.p2p.WifiP2pManager.PeerListListener; 
android.os.Bundle; 

android.util.Log; 
android.view.LayoutInflater; 
android.view.View; 
android.view.ViewGroup; 
android.widget.ArrayAdapter; 
android.widget.ListView; 


android.widget.TextView; 
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public void onListItemClick (ListView 1, View v, int position, long id) { 
WifiP2pDevice device= (WifiP2pDevice) getListAdapter().getItem (position) ; 

((DeviceActionListener) getActivity()) .showDetails (device) ; 

) 


J** 
* Array adapter for ListFragment that maintains WifiP2pDevice list. 
E 

private class WiFiPeerListAdapter extends ArrayAdapter<WifiP2pDevice>{ 


private List<WifiP2pDevice>items; 
public WiFiPeerListAdapter (Context context, int textViewResourceld, 
List«WifiP2pDevice»objects) { 
super (context, textViewResourceId, objects) ; 
items-objects; 


GOverride 
public View getView (int position, View convertView, ViewGroup parent) { 
View v-convertView; 
if (v--null) ( 
LayoutInflater vi- (LayoutInflater) getActivity().getSystemService ( 
Context.LAYOUT INFLATER SERVICE) ; 
v-vi.inflate (R.layout.row devices, null) ; 
l 
WifiP2pDevice device=items.get (position) ; 
if (device !=null) { 
TextView top= (TextView) v.findViewById (R.id.device_name) ; 
TextView bottom= (TextView) v.findViewById (R.id.device_details) ; 
if (top !=null) { 
top.setText (device.deviceName) ; 
5 
if (bottom !-null) { 
bottom.setText (getDeviceStatus (device.status)) ; 


return v; 


} 

public void updateThisDevice (WifiP2pDevice device) { 
this.device=device; 
TextView view= (TextView) mContentView.findViewById (R.id.my_name) ; 
view.setText (device.deviceName) ; 
view- (TextView) mContentView.findViewById (R.id.my status) ; 
view.setText (getDeviceStatus (device.status)) ; 


public void onPeersAvailable (WifiP2pDeviceList peerList) ( 
if (progressDialog !=null && progressDialog.isShowing()) { 
progressDialog.dismiss(); 
1 


peers.clear(); 
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import java.net.Socket; 


public class FileTransferService extends IntentService { 


private static final int SOCKET_TIMEOUT=5000; 

public static final String ACTION SEND FILE-"com.example.android.wifidirect.SEND FILE"; 
public static final String EXTRAS FILE PATH-"file url"; 

public static final String EXTRAS GROUP OWNER ADDRESS-"go host"; 

public static final String EXTRAS GROUP OWNER PORT-"go port"; 


public FileTransferService (String name) { 
super (name) ; 


public FileTransferService() { 
super ("FileTransferService") ; 


} 
@Override 
protected void onHandleIntent (Intent intent) { 


Context context=getApplicationContext (); 

if (intent.getAction().equals (ACTION SEND FILE)) { 
String fileUri-intent.getExtras().getString (EXTRAS FILE PATH) ; 
String host-intent.getExtras().getString (EXTRAS GROUP OWNER ADDRESS) ; 
Socket socket-new Socket (); 


int port-intent.getExtras().getInt (EXTRAS GROUP OWNER PORT) ; 


try ( 
Log.d (WIFIDirectDemoActivity.TAG, "Opening client socket - ") ; 
socket.bind (null) ; 
socket.connect ((new InetSocketAddress (host, port)) , SOCKET_TIMEOUT) ; 


Log.d (WIFIDirectDemoActivity.TAG, "Client socket - "+socket.isConnected()) ; 
OutputStream stream-socket.getOutputStream(); 
ContentResolver cr-context.getContentResolver(); 
InputStream is-null; 
try { 
is-cr.openInputStream (Uri.parse (fileUri)) ; 
) catch (FileNotFoundException e) { 
Log.d (WIFIDirectDemoActivity.TAG, e.toString()) ; 
} 
DeviceDetailFragmentl.copyFile (is, stream) ; 
Log.d (WIFIDirectDemoActivity.TAG, "Client: Data written") ; 
} catch (IOException e) { 
Log.e (WIFIDirectDemoActivity.TAG, e.getMessage()) ; 
) finally ( 
if (socket !-null) { 
if (socket.isConnected()) { 
try { 
socket.close(); 
} catch (IOException e) { 
// Give up 


e.printStackTrace () ; 
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8.5 NFC 


8.5.1 NFC 简介 


NEC (Near Field Communication) 也 叫 近 场 通信 技术 ， 是 基于 Android 系统 设备 最 有 特色 的 技 
术 之 一 。NFC 是 一 种 近 距 离 的 无 线 通信 技术 ， 通 常 的 通信 距离 是 4 厘米 或 更 短 。NFC 的 工作 频率 
是 13.56M Hz， 传 输 速率 是 106kbit/s~848kbit/s。 通 过 NFC 技术 ， 可 以 使 Android 设备 与 NFC Tag 
之 间或 者 其 他 Android 设备 之 间 传 输 小 数据 量 的 数据 。 

NFC Tag 分 很 多 种 ， 其 中 简单 的 只 提供 读 写 段 ， 有 的 只 能 读 、 不 能 写 : 复杂 的 Tag 可 以 支持 
一 些 数学 运算 ， 通 过 加 密 硬件 来 控制 对 Tag 中 特定 数据 段 的 读 写 ; 甚至 一 些 Tag 上 有 简单 的 操作 
系统 ， 人 允许 与 Tag 上 执行 的 代码 进行 一 些 相 对 复杂 的 交互 。 

NFC 总 是 在 一 个 发 起 者 和 一 个 被 动 目标 之 间 发 生 。 发 起 者 发 出 近 场 无 线 电波 ， 这 个 近 场 可 以 
给 被 动 目标 供电 。 发 起 者 一 般 为 Android 设备 ， 被 动 的 目标 包括 不 需要 电源 的 标签 、 卡 等 ， 也 可 以 
是 有 电源 的 设备 ， 如 Android FHL. NFC 技术 为 手机 支付 提供 了 技术 基础 。 

与 蓝牙 和 WIFI 技术 相 比 ，NFC 的 通信 带宽 和 距离 都 要 小 得 多 , 但 是 它 成 本 低 , 不 需要 电源 支 
持 ， 这 些 都 是 得 天 独 厚 的 应 用 推广 条 件 。 

为 了 推动 NEC 的 发 展 和 普及 ,业界 创建 了 一 个 非 营 利 性 的 标准 组 织 一 一 NFC Forum, 力求 促 
进 NEC 技术 的 实施 和 标准 化 ， 确 保 设 备 和 服务 之 间 协 同 合作 。 目 前 ，NFC Forum 在 全 球 拥有 数 
百 个 成 员 ， 包 括 SONY、Phlips、LG、Motorola、NXP、NEC、 三 星 、atoam、Intel 等 。2011 年 4 
F, Google 加 入 NFC 论坛 组 织 ， 推 动 了 NFC 技术 的 推广 。 








8.5.2 Android NFC 技术 


Android 提供 了 android.nfe 和 android.nfc.tech 包 ， 它 们 对 NFC 技术 进行 了 支持 。 常 用 类 介绍 
如 下 。 

e NfcManager: Android 设备 的 NFC 适配器 管理 器 ， 可 以 通过 getSystemService (String) 获得 
对 和 象 实例 。NfeManager 可 以 获取 到 当前 Android 设备 支持 的 所 有 NFC 适配器 列表 。 

© NfcAdapter: 代表 设备 的 NFC 适配器 。NEFC 适配器 是 进行 NFC 操作 的 入 口 。 通 常情 况 下 ， 
每 个 Android 设备 只 有 一 个 NFC 适配器 ， 可 以 通过 NfcAdapter getDefaultAdapter 

(android.contentContext ) 方法 或 者 NfeManagergetDefaultAdapter( 方 法 来 获取 当前 Android 

设备 的 NFC 适配器 。 

* NdefMessage: 代表 NDEF 消息 。NDEF 是 NFC Forum 定义 的 标准 数据 结构 ， 用 于 在 设备 和 
NEC Tags 之 间 传 递 数 据 。 一 个 NdefMessage 对 象 包含 多 个 NdefRecord 对 象 。 
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© NdefRecord: 代表 一 条 记录 。 每 条 NDEF 记录 都 有 一 个 MIME 数据 类 型 ， 比 如 文本 、URL、 
智慧 型 海报 等 。NDEF 记录 被 存放 在 NDEF 消息 中 。 
© Tag: 表示 被 检测 到 的 NFC 目标 ,可 以 是 一 个 标签 、 一 个 卡片 、 一 个 钥匙 扣 等 。 


Android.nfc.tech 包 中 包含 对 NFC Tag 进行 查询 和 VO 操作 的 类 。 
如 果 Android 设备 没有 关闭 掉 NFC 功能 , 当 设备 的 屏幕 没有 被 锁定 时 ，Android 设备 会 一 直 搜 
寻 附 件 的 NFC Tag。 当 一 个 NFC Tag 被 检测 到 ， 一 个 包含 该 NFC Tag 信息 的 Tag 对 象 将 被 创建 并 
且 封装 到 一 个 Intent E, 然后 NFC 发 布 系统 将 这 个 Intent 用 startActivity 发 送 到 已 注册 的 用 于 处 理 
这 种 类 型 的 Intent 的 Activity 中 进行 处 理 。 
当 Android 设备 扫描 到 一 个 NFC Tag, 通用 的 行为 是 自动 搜寻 最 合适 的 Activity 处 理 这 个 包含 
Tag 对 象 的 Intent， 而 不 需要 用 户 来 选择 哪个 Activity 来 处 理 。 因 为 设备 扫描 NFC Tag 是 在 很 短 的 
范围 和 时 间 内 , 如 果 让 用 户 选 择 的 话 , 就 有 可 能 需要 移动 设备 , 这样 将 会 打 断 这 个 扫描 过 程 。 因 此 ， 
开发 者 应 该 开发 只 处 理 需 要 处 理 的 Tag 的 Activity， 以 防止 发 生 让 用 户 选择 使 用 哪个 Activity 来 处 
理 的 情况 。 
Android 系统 提供 了 一 个 Tag 发 布 系统 (Tag Dispatch System) 帮助 分 析 扫 描 到 的 NFC Tag, 
从 中 提取 相关 数据 ,封装 到 Intent 并 且 定 位 到 对 这 些 数据 有 兴趣 的 Activity。 如 果 同 时 有 多 个 Activity 
都 可 以 对 封装 了 Tag 数据 的 Intent 进行 处 理 ， 那 么 会 出 现 一 个 选择 列表 ， 让 用 户 来 选择 要 处 理 的 
Activity。 
Tag 发 布 系统 定义 了 三 种 ntent， 按 照 顺序 优先 级 从 高 到 低 说 明 如 下 。 
* android.nfe.actionNDEF DISCOVERED: 当 一 个 包含 NDEF 负载 的 Tag 被 检测 到 时 , 该 Intent 
被 启动 ， 这 是 最 高 优先 级 的 Intent。 如 果 检 测 到 的 是 一 个 未 知 的 Tag 或 者 不 包含 NDEF 负载 
的 Tag, JR 4iX Intent 不 会 被 启动 。 若 NDEF DISCOVERED Intent 已 经 被 启动 ， 则 
TECH DISCOVERED 和 TAG DISCOVERED Intent 将 不 会 被 启动 。 


处 理 该 Intent 的 Activity 需要 对 应 设置 intent-filter 属性 ， 例 如 : 


<intent-filter> 
<action android:name-"android.nfc.action.NDEF DISCOVERED"/» 
<category android:name-"android.intent.category.DEFAULT"/» 
<data android:mimeType-"text/plain" /» 

</intent-filter> 


表明 当前 Activity 可 以 处 理 NDEF DISCOVERED 类 型 的 Intent， 但 是 其 携带 数据 的 类 型 需要 
JÆ "text/plain" XH. 

* android.nfc.action. TECH. DISCOVERED: 当 一 个 包含 NDEF 负载 的 Tag 被 检测 到 ， 并 且 没 有 
Activity 处 理 NDEF DISCOVERED Intent 时 ， 该 Intent 会 被 启动 。 若 该 Intent 被 启动 ， 则 
TAG DISCOVERED 不 会 被 启动 。 

e android.nfc.action TAG DISCOVERED: 当 一 个 包含 NDEF 负载 的 Tag 被 检测 到 ， 并 且 没 有 
Activity 处 理 NDEF DISCOVERED 和 TECH DISCOVERED Intent 时 ， 或 者 Tag 被 检测 为 未 
知 的 ， 该 Intent 被 启动 。 


总 的 来 说 ，Tag 发 布 系统 的 运行 过 程 如 图 8.11 所 示 。 
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图 8.11 Tag 发 布 系统 运行 图 
要 进行 NFC 访问 ， 需 要 在 工程 的 AndroidManifest.xml 文件 中 添加 如 下 代码 : 
e 用 于 获取 NEC 硬件 访问 权限 。 

<uses-permission android:name-"android.permission.NFC" /» 


o 指定 最 小 SDK 版 本 的 代码 。 支 持 NFC 功能 的 最 小 SDK 版 本 为 API Level 9， 但 是 仅 支 持 有 
限 的 Tag 发 布 和 访问 NDEF 信息 ， 不 支持 其 他 Tag 的 输入 输出 操作 。API Level 10 增加 了 对 
Tag 的 读 写 方式 ， 并 添加 了 前 台 NDEF 推 数据 的 方式 。API Level 14 提供 了 将 NDEF 数据 传 
送 到 其 他 设备 的 方式 。 建立 SDK 的 最 小 版 本 要 高 于 10. 


<uses-sdk android:minSdkVersion="10"/> 


o 设置 uses-feature 属性 ， 以 便 在 Google Play Store 发 布 时 ， 仅 使 具有 NFC 硬件 的 设备 可 以 搜 
REL 


<uses-feature android:name="android.hardware.nfc" android:required="true" /> 


8.5.3 ”使 用 前 台 发 布 系统 


前 台 发 布 系统 允许 Activity 截获 到 Intent 并 且 获 得 比 其 他 的 能 够 处 理 该 Intent 的 Activity 更 高 
的 权限 。 使 用 前 台 发 布 系统 涉及 为 Android 系统 构建 一 些 数据 结构 ， 以 便 能 够 发 送 合适 的 Intent 到 
应 用 程序 。 
要 使 用 前 台 发 布 系统 ， 需 要 执行 以 下 操作 。 
(1) 在 Activity 的 onCreate() 方 法 中 添加 以 下 代码 : 
© 创建 一 个 PendingIntent 对 象 ， 以 便当 Android 系统 检测 到 Tag 时 能 够 获取 到 这 个 对 象 的 详细 
信息 。 


PendingIntent pendingIntent-PendingIntent.getActivity ( 
this,0, new Intent (this, getClass()).addFlags(Intent.FLAG ACTIVITY SINGLE TOP),0); 


© 定义 用 于 处 理 要 截获 的 ntent 的 Intent Filter。 当 系统 检测 到 NFC Tag 时 ， 前 台 发 布 系统 会 核 
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实 当前 Activity 的 Intent Filter 是 否 与 要 截获 的 Intent 符合 。 若 符合 ， 则 由 当前 的 Activity 对 
Intent 进行 处 理 ; 若 不 符合 ， 则 前 台 发 布 系统 将 ntent 发 送 给 Intent 发 布 系统 。 下 面 的 代码 处 
理 了 所 有 的 MIME 数据 类 型 。 


IntentFilter ndef=new IntentFilter (NfcAdapter.ACTION NDEF DISCOVERED) ; 
try { 
ndef.addDataType ("*/*") ; /* Handles all MIME based dispatches. 
You should specify only the ones that you need. */ 
} 
catch (MalformedMimeTypeException e) ( 
throw new RuntimeException ("fail", e) ; 


} 
intentFiltersArray=new IntentFilter[] {ndef, }; 


e 设置 要 处 理 的 Tag Technology 列表 。 
techListsArray-new String[][] { new String[] { NfcF.class.getName()} }; 


(2) 覆盖 onPause0 和 onResume( 方 法 来 打开 或 关闭 前 台 发 布 系统 。enableForegroundDispatch() 方 法 
只 能 在 主线 程 中 并 且 Activity 在 前 台 时 被 调用 。 另 外 ， 应 该 实行 onNewIntent( 方 法 对 从 NFC Tag 
中 获取 到 的 数据 进行 处 理 。 相 关 代码 如 下 : 


public void onPause() { 
super.onPause(); 
mAdapter.disableForegroundDispatch (this) ; 


public void onResume() { 
super.onResume () 7 


mAdapter.enableForegroundDispatch (this, pendingIntent, intentFiltersArray, 
techListsArray) ; 


) 


public void onNewIntent (Intent intent) { 
Tag tagFromIntent-intent.getParcelableExtra (NfcAdapter.EXTRA TAG) ; 
//do something with tagFromIntent 


(3) 读 写 NFC Tag 数据 。 下 面 的 代码 演示 了 处 理 TAG DISCOVERED Intent 并 且 使 用 迭代 器 
读 取 NFC Tag 中 的 NDEF 数据 的 方法 : 


NdefMessage[] getNdefMessages (Intent intent) { 
// Parse the intent 
NdefMessage[] msgs=null; 
String action-intent.getAction(); 
if (NfcAdapter.ACTION TAG DISCOVERED.equals (action)) { 
Parcelable[] rawMsgs-intent.getParcelableArrayExtra (NfcAdapter.EXTRA NDEF MESSAGES) ; 
if (rawMsgs !=null) { 

msgs=new NdefMessage[rawMsgs.length]; 
for (int i-0; i«rawMsgs.length; i++) ( 

msgs[i]- (NdefMessage) rawMsgs [i]; 


else ( 
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// Unknown tag type 
byte[] empty=new byte[] {}; 


NdefRecord record-new NdefRecord (NdefRecord.TNF UNKNOWN, empty, empty, empty) ; 
NdefMessage msg=new NdefMessage (new NdefRecord[] {record}) ; 
msgs=new NdefMessage[] {msg}; 


} 
} 
else { 


Log.e (TAG, "Unknown intent "+intent) ; 


finish(); 
} 
return msgs; 


} 


下 面 的 代码 演示 了 写 简单 的 文本 到 NFC Tag 中 的 方法 : 


NdefFormatable tag-NdefFormatable.get (t) ; 


Locale locale-Locale.US; 


final byte[] langBytes=locale.getLanguage() .getBytes (Charsets.US ASCII) ; 


String text-"Tag, you're it!"; 
final byte[] textBytes-text.getBytes (Charsets.UTF 8) ; 


final int utfBit-0; 


final char status- (char) (utfBit+langBytes.length) ; 
final byte[] data-Bytes.concat (new byte[] ( (byte) status), langBytes, textBytes) ; 
NdefRecord record-NdefRecord (NdefRecord.TNF WELL KNOWN, NdefRecord.RTD TEXT, new byte[0], 


data) ; 
try ( 
NdefRecord[] records={text}; 


NdefMessage message-new NdefMessage (records) ; 


tag.connect () ; 
tag.format (message) ; 
) 
catch (Exception e) ( 
//do error handling 


) 


8.6(1 USB 简介 


8.6 USB 


Android 系统 支持 多 种 USB 外 围 设备 ， 提 供 两 种 模式 来 支持 实现 Android 附件 协议 USB 外 设 





接 入 系统 : USB 附件 模式 和 USB 3 


E 机 模式 。 





在 USB 附件 模式 下 , 接 入 的 USB 设备 充当 USB 3 
子 包括 机 器 人 控制 器 、 诊 断 和 音乐 设备 、 读 卡 器 等 。 这 种 模式 使 不 具备 主机 功能 的 Android 设备 
具有 了 与 USB 硬件 交互 的 能 力 。Android USB 附件 被 设计 用 来 与 装 有 Android 的 设备 一 起 工作 ， 
并 且 必 须 遵循 Android 附件 通信 协议 (Android Accessory Communication Protocol) 。 

在 USB 主机 模式 下 ，Android 设备 扮演 主机 的 角色 。 这 种 设备 的 例子 包括 数码 相机 、 键 盘 、 
鼠标 和 游戏 手柄 等 。 那 些 适 应 面 很 广 的 USB 设备 可 以 与 Android 应 用 程序 交互 ， 只 要 Android 系 


E 机 ， 并 为 USB 总 线 供电 。USB 附件 的 例 
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统 可 以 正确 地 与 这 些 设 备 进行 通信 。 
图 8.12 展示 了 两 种 模式 的 异同 。 当 Android 设备 处 于 主机 模式 时 ， 它 扮演 USB 主机 的 角色 并 
为 总 线 供 电 。 当 Android 设备 处 于 附件 模式 时 ， 连 接 的 USB 设备 扮演 主机 角色 并 给 总 线 供电 。 


Host Mode a M 
Aroma; hake La ated 
Wc Transfer 


图 8.12 两 种 USB 模式 
USB 附件 模式 和 USB 主机 模式 在 Android 3.1 (API level 12) 或 更 高 的 SDK 平台 中 被 直接 支 
。 在 Android 2.3.4 (API level 10) 系统 中 也 可 以 通过 添加 附加 库 的 方式 来 获得 支持 。 设 备 生产 商 
ison apu ZIDE o 





8.6.2 USB 附件 


Android USB 附件 模式 允许 Android 设 备 以 附件 形式 连接 到 USB 主机 上 ,附件 必须 遵循 Android 
Accessory Protocol 协议 。 附 件 模 式 使 得 不 能 以 USB 主机 方式 工作 的 Android 设备 与 USB 主机 进行 
交互 。 

1. API 的 选择 

在 开发 USB 附件 应 用 程序 时 ， 首 先 应 该 考虑 的 问题 是 选择 正确 的 USB 附件 API。 

对 应 Android 3.1 (API Level 12) 及 其 以 上 版 本 的 操作 系统 ，Android SDK 直接 提供 了 USB 附 
件 开 发 包 ， 名 为 android.hardware.usb。 

对 于 早期 的 Android 2.3.4 (API Level 10) 版 本 的 操作 系统 ，Android SDK 没有 提供 相应 的 
发 包 ， 只 能 通过 Google 的 附加 库 来 完成 USB 附件 模式 的 相关 开发 工作 ， 包 名 为 
com.android.future.usb。 实 质 上 ，Google 的 这 个 附加 库 是 对 Android 框架 API 的 包装 ， 相 当 于 
android.hardware.usb 包 的 一 个 简化 包 ， 仅 支持 附件 模式 的 开发 ， 不 支持 主机 模式 的 开发 。 

由 于 Google 附件 库 是 Android 框架 API 的 包装 库 ， 因 此 支持 USB 附件 的 API 是 相同 的 ， 主 
要 有 以 下 两 个 类 。 

e UsbManager: 负责 枚 举 连 接 的 USB 附件 设备 ， 并 与 附件 通信 。 

* UsbAccessory: 表示 一 个 USB 附件 设备 ， 并 且 包 含 访问 附件 的 标识 信息 的 API 


虽然 USB 附件 开发 的 相关 的 类 相同 ， 但 是 在 使 用 方法 上 有 两 处 不 同 。 
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获取 UsbManager 实例 的 方法 不 同 。 


对 于 Google 附加 库 ， 应 使 用 如 下 代码 获取 UsbManager 的 实例 : 


UsbManager manager-UsbManager.getInstance (this) ; 





对 于 Android 框架 API， 应 该 使 用 如 下 代码 : 


UsbManager manager= (UsbManager) getSystemService (Context.USB SERVICE) ; 


当 通过 Intent Filter 对 连接 的 USB 附件 进行 过 滤 时 ， 代 码 有 所 不 同 。 此 时 ，UsbAccessory 对 
象 会 被 包含 在 Intent 对 象 中 传递 给 应 用 程序 。 


对 于 Google 附加 库 ， 应 该 使 用 如 下 代码 


UsbAccessory accessory=UsbManager.getAccessory (intent) ; 


如 果 使 用 的 是 Android 框架 API， 则 应 该 使 用 如 下 代码; 


UsbAccessory accessory=(UsbAccessory)intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY); 


2. 


AndroidManifest.xml 文件 设置 


应 用 程序 的 Manifest 文件 应 该 做 如 下 设置 : 


由 于 并 不 是 所 有 的 Android 设备 都 支持 USB 附件 API, 因此 需要 在 应 用 程序 的 Manifest 文 件 
中 使 用 <uses-feature> 属 性 来 声明 当前 的 应 用 程序 使 用 了 android. hardware.usb.accessory 特性 。 

如 果 使 用 的 是 Google 附加 库 ， 需 要 使 用 <uses-library> 属 性 添加 com.android.future. 
usb.accessory 库 的 支持 。 

根据 选用 的 API 设 置 最 小 SDK 版 本 ， 如 果 是 Google 附加 库 ， 最 小 API Level 应 该 为 10， 如 
果 使 用 的 是 框架 API， 则 该 值 应 该 为 12。 

如 果 需 要 当前 应 用 程序 在 USB 附件 连接 时 获得 通知 ， 则 应 该 在 主 Activity 中 为 
android.hardware.usb.action USB ACCESSORY ATTACHED intent 44 Æ <intent-filter> 属性 和 
<meta-data> 属 性 对 。 其 中 ，<meta-data> 属 性 指向 一 个 外 部 的 XML 资源 文件 ， 其 中 包含 要 检 
测 的 附件 的 识别 信息 。 

在 XML 资源 文件 中 ， 通 过 <usb-accessory> 属 性 为 要 过 滤 的 USB 附件 定义 声明 信息 ， 该 属性 
可 以 包含 manufacture, model 和 version 属性 。 该 资源 文件 被 保存 在 res/xml 文件 夹 下 ， 其 文 
件 名 字 应 该 和 上 面 提 到 的 <meta-data> 中 指定 的 文件 名 字 相 同 (不 含 xml SH). 


下 面 的 代码 演示 了 在 应 用 程序 的 AndroidManifest.xml 文件 中 ,关于 USB 附件 API 的 设置 内 容 : 


<manifest ...> 


<uses-feature android:name-"android.hardware.usb.accessory" /» 
«uses-sdk android:minSdkVersion-"«version»" /> 
«application» 

«uses-library android:name-"com.android.future.usb.accessory" /» 


«activity ...> 


<intent-filter> 
<action android:name-"android.hardware.usb.action.USB ACCESSORY ATTACHED" /> 
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</intent-filter> 


<meta-data android:name-"android.hardware.usb.action.USB ACCESSORY ATTACHED" 
android: resource="@xml/accessory filter" /> 
</activity> 
</application> 
</manifest> 


其 中 : 


«meta-data android:name-"android.hardware.usb.action.USB ACCESSORY ATTACHED" 
android: resource="@xml/accessory filter" /> 


表明 USB 附件 的 相关 信息 ， 包 括 附件 模型 、 生 产 商 、 版 本 等 信息 ， 被 保存 在 res/xml/ 
xml/accessory filter.xml 文件 中 。 当 USB 附件 连接 到 Android 主机 时 ， 这 些 信 息 都 会 被 发 送 给 应 用 
程序 进行 过 滤 。 该 文件 示例 代码 如 下 : 

<?xml version-"1.0" encoding-"utf-8"?» 

«resources» 


<usb-accessory model-"DemoKit" manufacturer-"Google" version-"1.0"/» 
</resources> 


3. 使 用 USB 附件 

当 用 户 将 USB 附件 连接 到 Android 设备 时 ，Android 系统 会 检测 相关 应 用 程序 是 否 对 连接 的 
USB 附件 感 兴趣 。 如 果 感 兴趣 ， 则 会 建立 对 USB 附件 的 通信 。 要 达到 这 个 目的 ， 应 用 程序 应 该 能 
够 完成 以 下 三 点 : 

© 通过 Intent Filter 发 现 连 接 的 USB 附件 设备 ， 可 以 通过 过 滤 附 件 连 接 事件 或 者 枚 举 所 有 连接 

的 USB 附件 设备 并 从 中 查找 合适 的 设备 的 方式 对 附件 进行 发 现 。 

e (65H PERSE USB 附件 进行 通信 的 权限 。 

o 通过 使 用 合适 的 接口 读 写 数据 的 方式 与 USB 附件 进行 通信 。 

(1) 使 用 Intent Filter 发 现 附件 的 方式 适合 想 让 应 用 程序 自动 检测 附件 的 情况 。 实 行 这 种 方式 
需要 在 应 用 程序 的 manifest 文件 中 为 Activity 添加 android.hardware.usb.action. 
USB ACCESSORY ATTACHED Intent 的 过 滤 功 能 , 并 通过 meta-data 属性 指定 对 USB 附件 信息 进 
行 描述 的 XML 文件 。 

Activity 设置 的 相关 代码 如 下 : 
<activity ...> 
有 


<action android:name-"android.hardware.usb.action.USB ACCESSORY ATTACHED" /> 
</intent-filter> 


<meta-data android:name-"android.hardware.usb.action.USB ACCESSORY ATTACHED" 
android: resource="@xml/accessory filter" /> 
</activity> 


资源 文件 accessory filter xml 的 内 容 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
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<resources> 
<usb-accessory manufacturer="Google, Inc." model="DemoKit" version="1.0" /> 


</resources> 

这 样 , 当 符合 要 求 的 USB 附件 被 连接 到 USB 主机 上 时 , 其 产生 的 Intent 对 象 就 会 被 该 Activity 
截获 ， 并 从 中 获取 代表 USB 附件 的 UsbAccessory 对 象 。 
对 于 Google 附加 库 ， 相 关 代码 如 下 : 


UsbAccessory accessory-UsbManager.getAccessory (intent) ; 


| 于 框架 API， 相 关 代码 如 下 : 


UsbAccessory accessory-(UsbAccessory)intent.getParcelableExtra(UsbManager.EXTRA ACCESSORY); 


(2) 枚 举 所 有 连接 的 USB 附件。 获取 所 有 连接 到 主机 的 USB 附件 的 代码 如 下 : 


UsbManager manager= (UsbManager) getSystemService (Context.USB SERVICE) ; 





AM 


UsbAccessory[] accessoryList-manager.getAcccessoryList(); 


(3) 获取 访问 USB 附件 的 权限 。 在 与 USB 附件 建立 通信 之 前 ， 必 须 明确 要 向 用 户 要 求 访问 
权限 。 通 过 调用 requestPermission0 方 法 向 用 户 显示 一 个 对 话 框 ， 要 求 与 附件 建立 连接 的 权限 。 用 
户 单 击 该 对 话 框 后 会 生成 一 个 Intent 对 象 并 广播 出 去 。 因 此 ， 该 应 用 程序 需要 创建 一 个 
BroadcastReceiver 来 接收 该 Intent 对 象 ， 并 从 中 获取 用 户 授权 。 

创建 BroadcastReceiver 的 相关 示例 代码 如 下 : 


private static final String ACTION_USB_PERMISSION= 
"com.android.example.USB PERMISSION"; 
private final BroadcastReceiver mUsbReceiver-new BroadcastReceiver () { 


public void onReceive (Context context, Intent intent) { 
String action=intent.getAction(); 
if (ACTION_USB_PERMISSION.equals (action)) { 
synchronized (this) { 
UsbAccessory accessory= (UsbAccessory) intent.getParcelableExtra 
(UsbManager.EXTRA ACCESSORY) ; 


if (intent.getBooleanExtra (UsbManager.EXTRA PERMISSION GRANTED, false)) ( 
if (accessory !-null) { 
//call method to set up accessory communication 


5 
else f 
Log.d (TAG, "permission denied for accessory "*accessory) ; 


该 BroadcastReceiver 被 创建 后 , 应 该 在 Activity 的 onCreate0 方 法 中 进行 注册 。 相 关 代 码 如 下 : 


UsbManager mUsbManager= (UsbManager) getSystemService (Context.USB SERVICE) ; 
private static final String ACTION USB PERMISSION- 
"com.android.example.USB PERMISSION"; 
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00; 


mPermissionIntent-PendingIntent.getBroadcast (this, 0, new Intent (ACTION USB PERMISSION) , 


IntentFilter filter-new IntentFilter (ACTION USB PERMISSION) ; 


registerReceiver (mUsbReceiver, filter) ; 


显示 向 用 户 要 求 访问 附件 权限 的 对 话 框 ， 需 要 使 用 requestPermission() 方 法 ， 代 码 如 下 : 


UsbAccessory accessory; 


mUsbManager.requestPermission (accessory, mPermissionIntent) ; 


(4) 5j USB 附件 进行 通信 。 可 以 通过 UsbManager 示例 获取 一 个 文件 描述 符 (FileDescriptor)， 


并 通过 该 文件 描述 符 建立 输入 输出 流 ， 进 而 达到 与 USB 附件 通信 的 目的 。 与 USB 附件 通信 的 过 程 
应 该 写 在 一 个 单独 的 线程 里 , 避免 阻塞 UI 线程 。 下 面 的 代码 演示 了 打开 USB 附件 并 进行 通信 的 过 


程 : 





UsbAccessory mAccessory; 
ParcelFileDescriptor mFileDescriptor; 
FileInputStream mInputStream; 
FileOutputStream mOutputStream; 


private void openAccessory () { 

Log.d (TAG, "openAccessory: "*accessory) ; 

mFileDescriptor-mUsbManager.openAccessory (mAccessory) ; 

if (mFileDescriptor !-null) ( 
FileDescriptor fd-mFileDescriptor.getFileDescriptor(); 
mInputStream-new FileInputStream (fd) ; 
mOutputStream-new FileOutputStream (fd) ; 
Thread thread-new Thread (null, this, "AccessoryThread") ; 
thread.start(); 


} 
在 线程 的 run0 方 法 中 ， 可 以 通过 FileInputStream 和 FileOutputStream 进行 读 写 附件 的 操作 。 


当 从 附件 中 使 用 FileInputStream 读 取 信息 时 , 应 该 保证 用 于 保存 读 取 数 据 的 缓冲 区 的 大 小 足够 容纳 
USB 数据 包 中 的 数据 。Android Accessory Protocol 中 支持 USB 数据 包 缓 冲 区 最 大 到 16384 字 节 。 


为 了 保证 信息 传输 的 安全 ， 建 议 声 明 16384 字 节 长 度 的 缓冲 区 。 


(5) 结束 与 USB 附件 的 通信 。 当 与 USB 附件 的 通信 结束 或 者 附件 被 从 系统 中 断 开 的 时 候 ， 








应 该 使 用 close0 方 法 关闭 文件 描述 符 。 下 面 的 代码 定义 了 一 个 监听 附件 被 移 除 的 事件 的 


BroadcastReceiver: 


BroadcastReceiver mUsbReceiver-new BroadcastReceiver()( 
public void onReceive (Context context, Intent intent) { 
String action-intent.getAction(); 


if (UsbManager.ACTION USB ACCESSORY DETACHED.equals (action)) { 
UsbAccessory accessory- (UsbAccessory) intent.getParcelableExtra 


(UsbManager.EXTRA ACCESSORY) ; 


if (accessory !=null) ( 
// call your method that cleans up and closes communication with the accessory 


$ 
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Hn 

在 应 用 程序 中 创建 该 BroadcastReceiver, 而 不 是 在 应 用 程序 的 Manifest 配置 文件 中 , 这 样 可 以 
保证 只 有 Activity 运行 时 才 对 USB 附件 断 开 事件 进行 处 理 。 而 附件 断 开 事件 只 会 被 发 送 给 当前 运 
行 的 Activity， 而 不 是 被 广播 给 所 有 的 应 用 程序 。 





8.6.3 USB 主机 


当 Android 设备 运行 在 USB 主机 模式 ， 它 就 像 一 个 真正 的 USB 主机 ， 给 USB 总 线 供电 并 枚 
举 所 有 连接 的 USB 附件 设备 。USB 主机 模式 仅 在 Android 3.1 及 其 更 高 版 本 的 系统 中 被 支持 。 


1 


. 相关 API 介绍 


与 USB 主机 相关 的 API 都 被 保存 在 android.hardware.usb 包 中 ， 相 关 类 介绍 如 下 。 


UsbManager: 用 于 枚 举 连 接 的 USB 附件 设备 ， 并 与 USB 附件 进行 通信 。 

UsbDevice: 表示 一 个 连接 的 USB 附件 设备 ， 包 含 访问 该 设备 的 标识 信息 、 接 口 和 端点 的 相 
UsbInterface: 表示 USB 设备 的 一 个 接口 ， 用 于 定义 USB 设备 的 一 系列 功能 。 一 个 设备 可 以 
有 一 个 或 者 多 个 接口 ， 这 些 接口 可 用 于 通信 人。 

UsbEndpoint: 表示 一 个 接口 的 端点 ， 相 当 于 接口 通信 的 通道 。 一 个 接口 可 以 拥有 一 个 或 者 多 
个 端点 ， 通 常 拥有 输入 和 输出 两 个 端点 用 于 设备 的 双向 通信 。 

UsbDeviceConnection: 表示 一 个 到 USB 设备 的 连接 ,用 于 在 端点 上 传输 数据 。 这 个 类 允许 用 
户 以 同步 或 者 非 同步 的 方式 双向 传输 数据 。 

UsbRequest: 表示 一 个 通过 UsbDeviceConnection 与 USB 设备 进行 通信 的 异步 请 求 。 
UsbConstants: 定义 了 一 些 USB 常量 ， 这 些 常量 与 Linux 内 核 中 linux/usb/ch9.h 的 定义 相同 。 





在 大 多 数 情况 下 ， 开 发 者 需要 使 用 上 面 提 到 的 所 有 的 类 来 与 USB 设备 连接 (UsbRequest 类 只 
有 在 要 求 异步 通信 时 才 会 被 使 用 ) 。 通 常情 况 下 ， 开 发 者 需要 通过 UsbManager 实例 去 获取 所 需 的 
UsbDevice 实例 ， 进 而 从 UsbDevice 实例 中 查找 合适 的 UsbInterface， 并 确定 要 用 于 通信 的 
UsbEndpoint， 最 后 建立 UsbDeviceConnection 与 USB 设备 的 通信 。 


2 


.Android Manifest 文件 配置 
由 于 并 不 是 所 有 的 Android 设备 都 支持 USB 附件 API， 因 此 需要 在 应 用 程序 的 Manifest 文件 
中 使 用 <uses-feature> 属 性 来 声明 当前 的 应 用 程序 使 用 了 android. hardware.usb.host 特性 。 
设置 最 小 SDK 版 本 ,该 值 应 该 大 于 12， 因 为 在 早期 的 Android SDK 版 本 中 不 支持 USB 主机 
模式 。 
如 果 需 要 当前 应 用 程序 在 USB 附件 连接 时 获得 通知 ， 则 应 该 在 主 Activity 中 为 
android.hardware.usb.action USB ACCESSORY ATTACHED Intent 指定 <intent-filter> 属 性 和 
<meta-data> 属 性 对 。 其 中 ，<meta-data> 属 性 指向 一 个 外 部 的 XML 资源 文件 ， 其 中 包含 要 检 
测 的 附件 的 识别 信息 。 


330 | Android 7 应 用 程序 开发 教程 





© 在 XML 资源 文件 中 ， 通 过 <usb-device> 属 性 为 要 过 小 的 USB 附件 定义 相关 信息 ， 该 属性 可 
以 包含 vendor-id、product-id、class、subclass、protocol ( device or interface) 等 属性 。 如 果 想 
过 滤 特 定 设备 ， 则 需要 使 用 vendor-id 和 product-id 属性 ; 如 果 想 过 滤 一 类 设备 ， 比 如 大 容量 
存储 设备 或 者 数码 相机 ， 则 应 该 使 用 class、subclass 和 protocol 属性 ; 如 果 这 些 属性 一 个 也 
不 指定 ， 则 所 有 的 USB 设备 都 不 会 被 过 滤 掉 。 该 资源 文件 被 保存 在 res/xml ZRF, HK 
件 名 字 应 该 和 上 面 提 到 的 <meta-data> 中 指定 的 文件 名 字 相 同 (AS xml SH), 





下 面 的 示例 代码 演示 如 何 定义 Manifest 文件 : 
<manifest ...> 
<uses-feature android:name-"android.hardware.usb.host" /> 
<uses-sdk android:minSdkVersion="12" /> 
<application> 
<activity ...> 
<intent-filter> 
<action android:name-"android.hardware.usb.action.USB DEVICE ATTACHED" /> 
</intent-filter> 


<meta-data android:name-"android.hardware.usb.action.USB DEVICE ATTACHED" 
android: resource="@xml/device_filter" /> 
</activity> 
</application> 
</manifest> 


在 这 个 示例 中 ， 自 由 文件 被 放置 在 res/xml/device filter.xml 中 ， 相 关 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 


<resources> 
<usb-device vendor-id="1234" product-id="5678" class="255" subclass="66" protocol="1" /> 
</resources> 


3. 使 用 USB 设备 

当 用 户 将 USB 设备 连接 到 Android 设备 时 ，Android 系统 会 检测 相关 应 用 程序 是 否 对 连接 的 
USB 设备 感 兴趣 。 如 果 感 兴趣 ， 则 会 建立 与 USB 设备 的 通信 。 要 达到 这 个 目的 ， 应 用 程序 应 该 能 
够 完成 以 下 三 点 。 

e iG it Intent Filter 发 现 连接 的 USB 设 备 ,可 以 通过 过 滤 设 备 连接 事件 或 者 枚 举 所 有 连接 的 USB 

设备 并 从 中 查找 合适 的 设备 的 方式 对 设备 进行 发 现 。 

e WA PERS USB 设备 进行 通信 的 权限 。 

e ”通过 使 用 合适 的 接口 读 写 数据 的 方式 与 USB 设备 进行 通信 人。 

(1) 使 用 Intent Filter 发 现 设备 的 方式 适合 想 让 应 用 程序 自动 检测 设备 的 情况 。 实 行 这 种 方式 
需要 在 应 用 程序 的 manifest 文件 中 为 Activity 添加 android.hardware.usb.action.USB_ 
ACCESSORY ATTACHED Intent 的 过 滤 功 能 ， 并 通过 meta-data 属性 指定 对 USB 设备 信息 进行 描 
IRKI KML 文件 。 

Activity 设置 的 相关 代码 如 下 : 
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«activity ...> 


<intent-filter> 
<action android:name-"android.hardware.usb.action.USB ACCESSORY ATTACHED" /> 
</intent-filter> 


<meta-data android:name-"android.hardware.usb.action.USB ACCESSORY ATTACHED" 
android: resource="@xml/device filter" /> 
</activity> 


资源 文件 device filter xml 的 内 容 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 


«resources» 
«usb-device vendor-id-"1234" product-id-"5678" /» 
</resources> 
这 样 , 当 符合 要 求 的 USB 设备 被 连接 到 USB 主机 上 时 , 其 产生 的 Intent 对 象 就 会 被 该 Activity 
截获 ， 并 从 中 获取 到 代表 USB 设备 的 UsbAccessory 对 象 。 


UsbAccessory accessory= (UsbAccessory) intent.getParcelableExtra (UsbManager.EXTRA_DEVICE) ; 


(2) 枚 举 所 有 连接 的 USB 设备 。 获 取 所 有 连接 到 主机 的 USB 设备 的 代码 如 下 : 


UsbManager manager= (UsbManager) getSystemService (Context.USB SERVICE) ; 
HashMap<String, UsbDevice>deviceList=manager.getDeviceList (); 
UsbDevice device-deviceList.get ("deviceName") 77 


如 果 需 要 ， 也 可 以 从 哈 希 表 中 获取 和 迭代 器 ， 对 每 一 个 设备 分 别 进行 处 理 ; 
UsbManager manager- (UsbManager) getSystemService (Context.USB SERVICE) ; 
HashMap<String, UsbDevice»deviceList-manager.getDeviceList(); 
Iterator<UsbDevice>deviceIterator=deviceList.values() .iterator(); 

while (deviceIterator.hasNext()) { 


UsbDevice device=deviceIterator.next () 
//your code 


(3) 获取 访问 USB 设备 的 权限 。 在 与 USB 设备 建立 通信 之 前 ， 必 须 明确 要 向 用 户 要 求 访问 
权限 。 通 过 调用 requestPermission0 方 法 向 用 户 显示 一 个 对 话 框 ， 要 求 与 设备 建立 连接 的 权限 。 用 
户 单 击 该 对 话 框 后 会 生成 一 个 Intent 对 象 并 广播 出 去 。 因 此 ， 该 应 用 程序 需要 创建 一 个 
BroadcastReceiver 来 接收 该 Intent 对 象 ， 并 从 中 获取 用 户 授 权 。 

创建 BroadcastReceiver 的 相关 示例 代码 如 下 : 
private static final String ACTION USB PERMISSION= 


"com.android.example.USB PERMISSION"; 
private final BroadcastReceiver mUsbReceiver=new BroadcastReceiver () { 








public void onReceive (Context context, Intent intent) { 
String action-intent.getAction(); 
if (ACTION USB PERMISSION.equals (action)) ( 
synchronized (this) { 
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UsbDevice device= (UsbDevice) intent.getParcelableExtra 


(UsbManager.EXTRA DEVICE) ; 


0) ; 


下 ， 


if (intent.getBooleanExtra (UsbManager.EXTRA_PERMISSION GRANTED, false)) { 
if (device !=null) { 
//call method to set up device communication 
F 
H 
else ( 
Log.d (TAG, "permission denied for device "+device) ; 


该 BroadcastReceiver 被 创建 后 ,应 该 在 Activity 的 onCreate() 方 法 中 进行 注册 。 相 关 代码 如 下 : 


UsbManager mUsbManager= (UsbManager) getSystemService (Context.USB_SERVICE) ; 
private static final String ACTION_USB_PERMISSION= 
"com.android.example.USB PERMISSION"; 


mPermissionIntent-PendingIntent.getBroadcast (this, 0, new Intent (ACTION USB PERMISSION) , 


IntentFilter filter-new IntentFilter (ACTION USB PERMISSION) ; 
registerReceiver (mUsbReceiver, filter) ; 


显示 向 用 户 要 求 访问 设备 权限 的 对 话 框 ， 需 要 使 用 requestPermission0 方 法 ， 代 码 如 下 : 


UsbAccessory accessory; 


mUsbManager.requestPermission (accessory, mPermissionIntent) ; 


(4) H USB 设备 进行 通信 。 与 USB 设备 进行 通信 可 以 异步 ， 也 可 以 同步 。 无 论 在 哪 种 情况 
与 USB 设备 通信 的 过 程 都 应 该 在 一 个 单独 的 线程 里 被 执行 ， 以 避免 阻塞 UI 线程 。 为 了 合理 地 


创建 与 USB 设备 的 通信 ， 开 发 者 需要 获取 要 通信 设备 的 适合 的 UsbInterface 和 UsbEndpoint 对 象 ， 并 
在 该 端点 上 建立 UsbDeviceConnection 并 发 送 通信 请 求 。 


总 体 来 说 ， 代 码 编写 应 该 完成 以 下 功能 : 

© 检查 UsbDevice 对 象 的 属性 ， 例 如 product-id, vendor-id 等 ， 以 确认 是 否 要 和 当前 设备 进行 通 
f&. 

o ”获取 合适 的 UsbInterface 和 UsbEndpoint 对 象 用 于 通信 。 

e 通过 UsbEndpoint 对 象 打开 UsbDeviceConnection, 

o 在 端点 上 使 用 bulkTransferQorcontrolTransfer() 传 输 数 据 。 该 过 程 应 该 在 单独 的 线程 中 进行 。 


下 面 的 代码 演示 了 使 用 同步 方式 进行 数据 传输 的 过 程 ， 该 示例 仅 用 于 演示 ， 在 真正 的 开发 过 


程 中 ， 应 该 注意 选择 合适 的 接口 和 端点 ， 并 且 在 单独 的 线程 中 进行 数据 传输 。 


private Byte[] bytes 
private static int TIMEOUT=0; 


private boolean forceClaim=true; 
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UsbInterface intf=device.getInterface (0) ; 

UsbEndpoint endpoint-intf.getEndpoint (0) ; 

UsbDeviceConnection connection-mUsbManager.openDevice (device) ; 
connection.claimInterface (intf, forceClaim) ; 

connection.bulkTransfer (endpoint, bytes, bytes.length, TIMEOUT) ; //do in another thread 


进行 异步 数据 传输 使 用 UsbRequest 类 来 初始 化 并 将 一 个 异步 请 求 放 入 请 求 队列 ， 然 后 调用 
requestWait0 方 法 等 待 结果 。 
(5) 结束 与 USB 设备 的 通信 。 当 与 USB 设备 的 通信 结束 或 者 设备 被 从 系统 中 断 开 的 时 候 ， 
应 该 通过 调用 releaseInterface0 方 法 和 close0 方 法 关闭 UsbInterface 和 UsbDeviceConnection。 下 面 的 代码 
定义 了 一 个 监听 设备 被 移 除 的 事件 的 BroadcastReceiver: 


BroadcastReceiver mUsbReceiver-new BroadcastReceiver(){ 
public void onReceive (Context context, Intent intent) { 
String action-intent.getAction(); 





if (UsbManager.ACTION USB ACCESSORY DETACHED.equals (action)) { 
UsbAccessory accessory- (UsbAccessory) intent.getParcelableExtra 
(UsbManager.EXTRA DEVICE) ; 
if (accessory !-null) ( 
// call your method that cleans up and closes communication with the device 


} 


n 


在 应 用 程序 中 创建 该 BroadcastReceiver, 而 不 是 在 应 用 程序 的 Manifest 配置 文件 中 , 这 样 可 以 
保证 只 有 Activity 运行 时 才 对 USB 设备 断 开 事件 进行 处 理 。 而 设备 断 开 事件 只 会 被 发 送 给 当前 运 
行 的 Activity， 而 不 是 被 广播 给 所 有 的 应 用 程序 。 


8.7 SIP 


8.7.1 SIP 简介 


Android 系统 提供 了 支持 SIP (Session Initiation Protocol) 的 API， 人 允许 开发 者 添加 基于 SIP 的 
因特网 电话 特性 到 自己 的 应 用 程序 中 。Android 包含 一 个 完整 的 SIP 协议 栈 ， 整 合 了 允许 轻松 创建 
来 电 和 去 电 的 电话 管理 服务 ， 而 不 必 开 发 者 直接 参与 管理 会 话 、 传 输 层 通信 、 音 频 录制 等 工作 。 

目前 SIP 已 经 被 成 功 应 用 于 视频 会 议和 即时 消息 中 , 其 应 用 程序 开发 需要 基于 Android 2.3( API 
Level 9) 以 上 的 系统 。SIP 运行 于 无 线 数 据 连 接 ， 通 过 AVD 无 法 调试 。 在 SIP 应 用 程序 通信 会 话 
中 ， 每 一 个 参与 者 都 必须 拥有 一 个 SIP 账号 。 








8.7.2 相关 API 


Android SDK 中 与 SIP 开发 相关 的 类 和 接口 被 放置 在 android net.sip 包 中 ， 相 关 类 和 接口 介绍 如 下 。 
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© SipAudioCal: 用 于 处 理 基于 SIP 的 因特网 音频 呼叫 。 
* SipAudioCall Listener: 用 于 处 理 SIP 呼叫 事件 ， 如 接收 到 呼叫 和 对 外 呼叫 事件 。 
* SipEmorCode: 定义 了 SIP 行为 的 错误 代码 。 
© SipManager: 提供 了 SIP 任务 的 相关 API， 例 如 初始 化 SIP 连接 ， 提 供 对 相关 SIP 服务 的 访 
问 等 。 
* SipProfile: 定义 了 一 个 SP 配置 文件 ， 包 括 SIP 账户 、 域 和 服务 器 信息 等 。 
© SipProfileBuilder: 创建 SIP 配置 信息 的 帮助 类 。 
© SipSession: 代表 一 个 与 SP 对 话 框 相关 联 的 SIP 会 话 或 者 一 个 单独 的 无 对 话 框 的 事务 。 
© SipSessionlistener: 针对 SIP 会 话 事件 的 监听 器 ， 例 如 会 话 被 注册 或 者 一 个 电话 正在 呼出 事 


fF. 
* SipSessionState: 定义 了 SIP 会 话 的 状态 信息 ， 例 如 注册 、 呼 出 、 呼 入 等 。 
© SipRegistrationListener: 一 个 用 于 监听 SIP 注册 事件 的 接口 。 


8.7.3 Manifest 文件 配置 


要 开发 基于 SIP 的 应 用 程序 , 必须 使 用 Android 2.3 以 上 版 本 的 设备 , 但 是 并 不 是 所 有 Android 


2.3 以 上 版 本 的 设备 都 支持 SIP 应 用 程序 。 


为 应 用 程序 添加 SIP 支持 需要 在 应 用 程序 的 配置 文件 AndroidManifest.xml 中 添加 如 下 内 容 。 
o 添加 使 用 SIP 和 因特网 的 权限 : 


<uses-permission android:name-"android.permission.USE SIP" /> 
<uses-permission android:name="android.permission. INTERNET" /> 


© ”确保 应 用 程序 只 可 以 被 安装 在 支持 SIP 的 设备 上 ， 在 Manifest 文件 中 添加 以 下 代码 : 


<uses-sdk android:minSdkVersion="9" /> 
<uses-feature android:name="android.hardware.sip.voip" /> 


© ”如 果 应 用 程序 被 设计 为 接收 呼叫 ， 则 必须 定义 一 个 receiver: 
<receiver android:name=".IncomingCallReceiver" android:label="Call Receiver"/> 


应 用 程序 的 Manifest 文件 示例 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android="http: //schemas.android.com/apk/res/android" 
package-"com.example.android.sip"» 


«receiver android:name-".IncomingCallReceiver" android:label-"Call Receiver"/> 


<uses-sdk android:minSdkVersion-"9" /> 
<uses-permission android:name-"android.permission.USE SIP" /> 
<uses-permission android:name="android.permission. INTERNET” /> 


«uses-feature android:name-"android.hardware.sip.voip" android:required-"true" /> 

«uses-feature android:name-"android.hardware.wifi" android:required-"true" /> 

«uses-feature android:name-"android.hardware.microphone" android:required-"true" /> 
</manifest> 
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8.7.4 创建 SipManager 对 象 


要 使 用 SIP API， 必 须 创 建 SipManager 示例 。SipManager 用 于 处 理 : 


e 初始 化 SIP 会 话 。 
”初始 化 并 接收 呼叫 。 

e 对 SIP 提供 者 进行 注册 和 注销 。 
e 核实 会 话 连接 。 

创建 SipManager 对 象 的 代码 如 下 : 


public SipManager mSipManager=null; 


if (mSipManager--null) { 
mSipManager-SipManager.newInstance (this) ; 
} 


8.7.5 注册 SIP 服务 器 


在 典型 的 Android SIP 应 用 程序 中 包含 一 个 或 多 个 用 户 ， 每 个 用 户 都 必须 有 一 个 SIP 账户 。 在 
SIP 应 用 程序 中 ，SIP 账户 用 SipProfile 对 象 表示 。 

SipProfile 定义 了 SIP 配置 简 表 ， 包 括 SIP 账户 以 及 域 和 服务 器 信息 。 与 运行 应 用 程序 的 设备 
上 的 SIP 账户 相关 联 的 配置 简 表 叫 作 本 地 简 表 , 会 话 连接 到 的 简 表 叫 作对 等 简 表 。 当 SIP 应 用 程序 
使 用 本 地 SipProfile 登录 到 SIP 服务 器 时 ，SipProfile 帮助 SIP 服务 器 高 效 地 将 当前 设备 注册 为 SIP 
呼叫 的 目的 地 。 

创建 SipProfile 对 象 的 代码 如 下 : 


public SipProfile mSipProfile=null; 


SipProfile.Builder builder=new SipProfile.Builder (username, domain) ; 
builder.setPassword (password) ; 
mSipProfile-builder.build(); 


下 面 代码 中 的 SipManager 打开 本 地 简 表 ， 用 于 拨打 或 者 接收 SIP 呼叫 : 


Intent intent=new Intent (); 

intent.setAction ("android.SipDemo. INCOMING CALL") ; 

PendingIntent pendingIntent-PendingIntent.getBroadcast (this, 0, intent, 
Intent.FILL IN DATA) ; 

mSipManager.open (mSipProfile, pendingIntent, null) ; 


下 面 的 代码 为 SipManager 注册 了 SipRegistrationListener 接口 ， 该 接口 用 于 跟踪 SipProfile 是 
APE SIP 服务 提供 者 处 成 功 注 册 。 
mSipManager.setRegistrationListener (mSipProfile.getUriString(), new 


SipRegistrationListener () { 


public void onRegistering (String localProfileUri) { 
updateStatus ("Registering with SIP Server...") ; 
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} 


public void onRegistrationDone (String localProfileUri, long expiryTime) { 
updateStatus ("Ready") ; 
Í; 


public void onRegistrationFailed (String localProfileUri, int errorCode, 


String errorMessage) { 
updateStatus ("Registration failed. Please check settings.") ; 


) 
下 面 的 代码 演示 了 配置 简 表 使 用 结束 后 ， 如 何 关闭 简 表 ， 并 从 服务 器 注销 设备 信息 。 


public void closeLocalProfile() { 
if (mSipManager==null) { 
return; 
) 
try { 
if (mSipProfile !=null) { 
mSipManager.close (mSipProfile.getUriString()) ; 


H 
) catch (Exception ee) { 
Log.d ("WalkieTalkieActivity/onDestroy", "Failed to close local profile.", ee) ; 


) 


87.6 拨打 音频 电话 


要 使 用 SIP 拨打 语音 电话 ， 需 要 满足 如 下 条 件 : 

© 一 个 SipProfile 对 象 ， 用 于 拨打 电话 ; 一 个 有 效 的 SIP 地址， 用 于 接收 电话 。 

e 一 个 SipManager 对 象 。 

为 了 拨打 音频 电话 ， 需 要 创建 SipAudioCall.Listener 对 象 。 大 部 分 的 客户 端 与 SP 栈 之 间 的 交 
互 都 是 通过 接口 进行 的 。 下 面 的 代码 演示 了 呼叫 建立 后 接口 如 何 进行 处 理 : 


SipAudioCall.Listener listener-new SipAudioCall.Listener() { 


@Override 
public void onCallEstablished (SipAudioCall call) { 


call.startAudio(); 
call.setSpeakerMode (true) ; 
call.toggleMute(); 


@Override 
public void onCallEnded (SipAudioCall call) { 


// Do something. 
} 
ye 


SipAudioCall Listener 接口 创建 后 ， 通 过 SipManager.makeAudioCall0 方 法 进行 音频 呼叫 。 该 方 
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法 有 4 个 参数 ， 分 别 是 : 


e 本 地 SIP 配置 简 表 (呼叫 者 )。 

© 对 等 SOP 配置 简 表 (被 呼叫 者 )。 
* SipAudioCallLListener 接口 。 

e 超时 时 间 ， 单 位 是 秒 。 

进行 音频 呼叫 的 代码 如 下 : 


call=mSipManager.makeAudioCall (mSipProfile.getUriString(), sipAddress, listener, 30) ; 


87.7 ”接收 呼叫 


为 了 接收 呼叫 ，SIP 应 用 程序 必须 包含 一 个 BroadcastReceiver 的 子 类 ， 以 便当 有 来 电 时 用 于 对 


Intent 


对 象 进行 处 理 。 为 此 ， 需 要 在 应 用 程序 中 完成 以 下 几 步 : 


* 在 AndroidManifestxml 文件 中 声明 <receiver>， 例 如 : 


< 


receiver android:name-".IncomingCallReceiver" android:label="Call Receiver"/>. 


日” 实现 声明 的 BroadcastReceiver 的 子 类 ， 例 如 IncomingCallReceiver. 
© 使 用 PendingIntent 对 象 初始 化 本 地 SipProfile。 当 有 来 电 时 ， 该 PendingIntent 会 启动 


BroadcastReceiver 的 子 类 。 


e 设置 Intent Filter， 用 于 过 滤 来 电 时 产生 的 Intent, 


下 面 的 代码 定义 了 一 个 用 于 处 理 来 电 的 BroadcastReceiver: 


/ 


*** Listens for incoming SIP calls, intercepts and hands them off to WalkieTalkieActivity. 
if 


public class IncomingCallReceiver extends BroadcastReceiver { 


[ee 
* Processes the incoming call, answers it, and hands it over to the 
* WalkieTalkieActivity. 
* @param context The context under which the receiver is running. 
* @param intent The intent being received. 
E 
@Override 
public void onReceive (Context context, Intent intent) { 
SipAudioCall incomingCall=null; 
try { 
SipAudioCall.Listener listener-new SipAudioCall.Listener () { 
@Override 
public void onRinging (SipAudioCall call, SipProfile caller) { 
try { 
call.answerCall (30) ; 
} catch (Exception e) { 
e.printStackTrace (); 


Hn 
WalkieTalkieActivity wtActivity- (WalkieTalkieActivity) context; 
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Intent Filter 信息 可 以 在 应 用 程序 的 Manifest 文件 中 被 注册 ， 也 可 以 像 下 面 的 代码 演示 的 那样 
在 Activity 的 onCreate0 方 法 中 被 注册 。 相 关 代 码 如 下 : 
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8.8 小 结 


本 章 主 要 讲解 了 Android 平台 上 网 络 通信 的 相关 内 容 ， 主 要 包括 因特网 通信 中 常用 的 HTTP 
通信 和 Socket 通信 ， 以 及 近 距 离 通信 中 的 蓝牙 通信 和 WIFI 通信 , 并 详细 介绍 了 网 络 通信 相关 的 各 
个 接口 和 类 的 使 用 方法 。 在 HTTP 通信 中 ， 介 绍 了 常用 的 HttpURLConnection 和 HttpClient 接口 的 
使 用 方法 ， 以 及 使 用 GET 和 POST 方法 获取 网 络 资源 的 方法 ; 在 Socket 通信 中 ， 介 绍 了 客户 端 和 
服务 器 端 Socket 的 编写 方法 ;在 蓝牙 通信 部 分 ， 讲 解 了 蓝牙 通信 过 程 中 涉及 的 相关 内 容 ， 例 如 探 
测 并 开启 手机 的 蓝牙 功能 、 蓝 牙 服 务 搜索 、 建 立 蓝 牙 连接 等 ，WIFI 通信 部 分 讲解 了 使 用 WIFI 进 
行 通信 的 方法 。 每 种 通信 方式 都 对 应 编写 了 一 个 实例 , 读者 可 以 从 实例 出 发 , 开发 自己 的 网 络 通信 
应 用 程序 。 

此 外 ， 本 章 还 介绍 了 Android 的 NFC 技术 ， 该 技术 用 于 近 距 离 通信 ， 通 信 对 象 可 以 是 无 源 设 
备 。 该 技术 为 手机 支付 应 用 程序 的 开发 提供 了 基础 。Android 的 USB 技术 允许 Android 设备 以 USB 
附件 方式 和 USB 主机 方式 与 其 他 USB 设备 进行 通信 。SIP 技术 为 Android 设备 上 的 视频 会 议和 即 
时 消息 提供 了 基础 。 


=H 


8.9 3 题 


1. 如 何 使 用 HttpURLConnection 获取 网 络 上 的 一 张 图 片 并 将 其 显示 出 来 ? 

2. 如 何 使 用 Socket 通信 方式 实现 一 个 简单 的 对 等 聊天 软件 ? 

3. 在 PC 上 建立 一 个 聊天 室 ， 用 户 可 以 通过 手机 参与 到 该 聊天 室 ， 该 如 何 实现 ? 
4. 使 用 蓝牙 如 何 进行 文件 传输 ? 

5. 如 何 使 用 WIFI 对 周围 可 用 Peers 进行 搜索 并 建立 连接 ? 


位 置 服务 (Location Based Services, LBS) 又 称 定位 服务 ， 是 指 通过 GPS 卫星 或 者 蜂窝 网 络 
获取 各 种 终端 的 地 理 坐 标 〈 经 度 和 纬度 ) ， 在 电子 地 图 平台 的 支持 下 ， 为 用 户 提供 基于 位 置 导航 、 
查询 的 一 种 信息 业务 。 它 涉及 图 服务 、 计 算 机 应 用 互 操作 、 无 线 通信 、 智 能 终端 等 技术 。 实 质 上 是 
一 种 概念 较为 宽泛 的 、 与 位 置 有 关 的 新 型 服务 业务 。 

LBS 系统 通过 移动 和 固定 网 络 发 送 基于 位 置 的 信息 与 服务 , 使 得 这 种 服务 可 以 应 用 到 任何 人 、 
任何 位 置 、 任 何 时 间 和 任何 设备 ， 这 就 是 LBS 的 优势 所 在 。 

GPS (Global Position System， 全 球 定位 系统 ) 是 20 世纪 70 年 代 由 美国 陆海空 三 军 联 合 研制 
的 新 一 代 空 间 卫 星 导 航 定位 系统 。 

由 于 卫星 的 位 置 精确 ， 在 GPS 观测 中 ， 我 们 可 以 得 到 卫星 到 接收 机 的 距离 ， 然 后 利用 三 维和 4 
标 中 的 距离 公式 和 3 颗 卫 星 就 可 以 组 成 3 个 方程 式 ， 解 出 观测 点 的 位 置 (X、Y、Z) 。 考 虑 到 了 
星 的 时 钟 与 接收 机 时 钟 之 间 的 误差 ， 实 际 上 有 4 个 未 知 数 ，X、Y、Z 和 时 钟 差 ， 然 后 用 4 个 方程 
将 这 4 个 未 知 数 解 出 来 ， 所 以 如 果 想 知道 接收 机 所 处 的 位 置 ， 至 少 要 能 接收 到 4 个 卫星 的 信号 ， 从 
而 得 到 观测 点 的 经 纬度 和 高 程 。 

2005 年 2 月 ，Google 推出 了 Google Maps， 该 服务 为 Google 的 搜索 服务 增加 了 影响 力 ， 之 后 
Google 也 将 GPS 应 用 放 在 了 Android 的 设备 中 。 

本 章 我 们 将 学 习 在 Android 系统 下 如 何 使 用 相关 API 实现 位 置 服务 功能 。 





m onm 


9.1 获取 位 置信 息 





手机 设备 的 移动 性 决定 了 手机 在 位 置 服务 方面 拥有 比 固 定 设备 更 多 的 优势 ， 可 以 开发 多 种 基 
于 移动 设备 的 位 置 服务 应 用 程序 。 
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Android SDK 提供 了 android.location 包 和 Google Maps API 支持 位 置 服务 功能 , 开发 人 员 可 以 
方便 地 开发 自己 的 位 置 服务 应 用 程序 。Android 系统 支持 GPS 定位 方式 和 网 络 定位 方式 。GPS 方式 


的 位 置信 息 来 自 了 





PR, MEIRA, (AE GPS 方式 仅 在 户外 有 效 ， 其 首次 获取 位 置 时 间 较 长 并 且 非 


常 耗费 电量 ; 而 网 络 定位 方式 使 用 的 是 移动 通信 基站 和 WIFI 信号 ， 这 种 方式 在 室内 和 户外 都 可 以 


使 用 ， 响 应 快速 ， 
的 定位 方式 。 


费 电 较 少 , 但 是 精度 难以 保证 。 开 发 者 应 该 根据 应 用 程序 的 使 用 环境 来 确定 具体 


9.1.1 LocationManager 介绍 


在 Android 的 位 置 服务 中 ，LocationManager 是 一 个 非常 重要 的 类 ， 它 位 于 android. location 包 
中 。LocationManager 类 用 于 管理 Android 用 户 位 置 服务 信息 ， 提 供 确定 用 户 位 置 的 API， 通 过 这 
个 类 可 以 实现 定位 、 跟 踪 和 目标 趋 近 等 功能 。 

LocationManager 对 象 不 能 直接 实例 化 ， 可 以 通过 Context.getSystemService ( Context. 


LOCATION SERVICE) 方法 获得 。 


LocationManager 对 象 可 以 完成 以 下 三 个 方面 的 任务 : 


© 从 用 户 的 位 置 查询 所 有 可 用 的 LocationProvider 列表 。 
© 从 特定 的 LocationProvider 周期 性 获取 用 户 当 前 位 置 的 功能 。 
日” 当 用 户 位 置 接近 某 个 特定 区 域 时 ， 启 动 相关 任务 。 


表 9.1 所 示 为 LocationManager 类 的 常用 方法 。 


常用 方法 
getAlIProviders() 


getBestProvider (Criteria criteria,Boolean enabldOny ) 


getLastKnownLocation (String provider) 


3&9.1 LocationManager 类 的 常用 方法 

方法 描述 

获得 所 有 LocationProvider 列表 

根据 criteria 返回 最 合适 的 LocationProvider， 其 中 
criteria 指定 了 一 系列 条 件 

根据 provider 获得 最 新 位 置信 息 




















getProvider (String name) 获得 指定 名 称 的 LocationProvider 

getProviders (boolean enabledOnly ) 获得 可 用 的 LocationProvider 列表 

ddProximityAlert (double latitude, double longitude, float | . "-— 
— m 设 定 目标 趋 近 警告 

radius, long expiration, PendingIntent intent) 

removeProximityAlert ( PendingIntent intent) 删除 趋 近 警告 





9.1.2 LocationProvider 介绍 


LocationProvider 为 位 置 提供 者 的 抽象 类 ， 位 置 提供 者 提供 手机 设备 周期 性 的 地 理 位 置 报告 。 
LocationProvider 的 常用 方法 如 表 9.2 所 示 。 
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表 9.2 LocationProvider 的 常用 方法 
































根据 设备 的 不 同 可 以 使 用 不 同 的 定位 技术 来 实现 位 置 服务 ， 也 就 是 获取 不 同 的 





常用 方法 方法 描述 

getAccuracy() 获取 LocationProvider 提供 位 置信 息 的 精度 
getName() 获得 LocationProvider 的 名 称 
getPowerRequirement() 获得 LocationProvider 对 电源 的 需求 
hasMonetaryCost() 获取 当前 LocationProvider 是 免费 的 还 是 收费 的 
meetsCriteria (Criteria criteria) 确定 当前 LocationProvider 是 否 符合 特定 条 件 
requiresCell() LocationProvider 定位 是 否 需要 访问 基站 网 络 
requiresNetwork() LocationProvider 定位 是 否 需要 Internet 网 络 数据 
requiresSatellite() LocationProvider 定位 是 否 需 要 获取 卫星 数据 
supportsA Ititude() LocationProvider 提供 的 位 置信 息 是 否 包含 高 度 信息 
supportsBearing() 是 否 能 够 提供 方向 信息 

supportsAltitude() LocationProvider 是 否 能 够 提供 速度 信息 


LocationProvider， 以 下 是 3 种 获取 LocationProvider 实例 的 方法 。 


e 通过 指定 名 称 获取 。 根 据 LocationManager 中 的 静态 常量 GPS PROVIDER 和 





NETWORK PROVIDER 来 分 别 获得 GPS Provider 和 Network Provider， 例 如 : 


LocationManager manager= (LocationManager) getSystemService 
(Context.LOCATION SERVICE) ; 

// 指 定 Provider 4#} LocationManager.GPS PROVIDER 

LocationProvider MyProvider-manager.getProvider (LocationManager.GPS PROVIDER) ; 
获取 可 使 用 的 LocationProvider 实例 列表 。 通过 调用 locationManager.getProviders ( true ) 方法 
就 可 以 获得 可 利用 的 LocationProvider 实例 列表 ， 例 如 : 

342oolean enabledOnly-true; 

// 获 取 Provider 的 集合 

List«String»providers-locationManager.getProviders (enabledOnly) ; 
根据 Criteria 获取 符合 条 件 的 LocationProvider 实例 ,每 个 LocationProvider 都 有 一 个 条 件 集合 ， 
以 便于 应 用 程序 可 以 选择 合适 的 位 置 提供 者 。 例 如 有 的 LocationProvider 要 求 设备 本 身 具有 
GPS 模块 ， 并 且 要 求 看 见 卫星 的 数量 ， 有 的 要 求 手机 设备 能 够 接 入 nemet 或 者 特定 网 络 等 。 
Criteria 类 被 用 于 为 LocationProvider 设置 相关 条 件 。 


Criteria 对 象 封装 了 获得 LocationProvider 实例 的 条 件 ， 可 以 根据 指定 的 Criteria 条 件 来 过 滤 


LocationProvider 列表 ， 以 得 到 符合 条 件 的 LocationProvider 实例 。 


Criteria 的 常用 方法 如 表 9.3 所 示 。 
表 9.3 Criteria 的 常用 方法 





常用 方法 方法 描述 


isAltitudeRequired() 返回 Provider 是 否 需 要 高 度 信息 





返回 Provider 是 否 需 要 方向 信息 


第 9 章 智能 传感器 | 343 




















( 续 表 ) 
常用 方法 方法 描述 
isSpeedRequired() 返回 Provider 是 否 需要 速度 信息 
isCostAllowed() 标识 是 否 允 许 产生 费用 


设置 Provider 的 精确 度 
设置 Provider 是 否 需要 高 度 信息 


setAccuracy (int accuracy) 
setAltitudeRequired (boolean altitudeRequired ) 




















setBearingRequired (boolean bearingRequired ) 设置 Provider 是 否 需要 方位 信息 
setSpeedRequired (boolean speedRequired) 设置 Provider 是 否 需要 速度 信息 
setCostAllowed (boolean costAllowed) 设置 是 否 需 要 产生 费用 
getAccuracy() 获取 位 置信 息 的 准确 度 





下 面 的 代码 使 用 Criteria 对 象 创建 了 一 个 条 件 集 ， 并 根据 该 条 件 集 查找 到 合适 的 
LocationProvider 对 象 ， 并 从 该 LocationProvider 对 象 获 取 位 置信 息 。 
// 获 取 Criteria 对 象 


Criteria criteria=new Criteria(); 

// 设 置 需要 更 精细 的 定位 精度 要 求 

criteria.setAccuracy (Criteria.ACCURACY_FINE) ; 

// 设 置 定位 不 需要 高 度 信息 

criteria.setAltitudeRequired (false) ; 

// 设 置 不 需要 提供 轴承 信息 

criteria.setBearingRequired (false) ; 

// 设 置 允许 收费 

criteria.setCostAllowed (true) ; 

// 设 置 低 耗 能 

criteria.setPowerRequirement (Criteria.POWER LOW) ; 
// 根 据 设置 的 条 件 获取 合适 的 Provider 

String provider=locationManager.getBestProvider (criteria,true) ; 
//f88l Location 对 象 


Location location-locationManager.getLastKnownLocation (provider) ; 


© ”LocationListener。 提 供 定位 信息 发 生 改 变 时 的 回调 功能 ， 此 接口 提供 了 4 个 常用 方法 ， 如 表 





9.4 所 示 。 
表 9.4 LocationListener 的 常用 方法 
常用 方法 方法 描述 
onLocationChanged 当 坐 标 改变 时 触发 此 方法 ， 如 果 Provider 传 进 相同 的 坐标 ， 它 就 不 


(Location location) 会 被 触发 

onProviderDisabled (String provider) Provider 禁用 时 触发 此 方法 ， 例 如 ，GPS 被 关闭 时 
onProviderEnabled (String provider) Provider 启用 时 触发 此 方法 ， 例 如 ，GPS 被 打开 时 

Provider 的 状态 在 可 用 AVAILABLE 、 暂 时 不 可 用 
TEMPORARILY UNAVAILABLE 和 无 服务 OUT OF SERVICE 三 
个 状态 之 间 切 换 时 触发 此 函数 


在 本 章 后 面 的 实例 中 ， 会 使 用 到 该 接口 。 








onStatusChanged ( String providerint 
status, Bundle extras ) 
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91.3 使 用 GPS 获取 当前 位 置信 息 





要 获取 精确 的 位 置 服 务 信息 需要 GPS 硬件 的 支持 。 在 应 用 程序 开发 阶段 ， 由 于 模拟 器 中 并 


有 真正 的 GPS 硬件 ， 因 此 不 能 获得 真实 的 GPS 信息 。 但 是 可 以 使 用 Eclipse 视图 模式 的 DDMS 模 
式 模拟 GPS 服务 ,在 如 图 9.1 所 示 的 Emulator Control 界面 中 手动 发 送 经 纬度 信息 来 测试 位 置 服务 。 


B) Emulator Control 5% 


Location Controls 


| Manual |Gpx | KML 


© Decimal 
Sexagesimal 

Longitude 123.4 

Latitude 41.8 


Send 





图 9.1 Emulator Control 界面 
获取 用 户 当前 位 置 ， 需 要 实现 以 下 4 个 基本 步骤 。 
€o) 在 AndroidManifest.xml 文件 中 声明 相应 的 权限 。 
使 用 GPS_PROVIDER 定位 服务 需要 以 下 权限 : 


<uses-permission android:name-"android.permission.ACCESS FINE LOCATION"/» 


fH] NETWORK PROVIDER 定位 服务 需要 以 下 权限 : 


<uses-permission android:name-"android.permission.ACCESS COARSE LOCATION"/> 


€X302 获取 LocationManager WR. 
CX308 选择 合适 的 LocationProvider。 
€o 通过 LocationListener 接口 获取 位 置信 息 。 


实例 GPSLocationDemo 演示 了 使 用 GPS 获取 用 户 信 息 的 过 程 ， 运 行 效果 如 图 9.2 所 示 。 


| GPSLocation 


获取 GPS 信息 


123.4 
41.79999833333333 





图 9.2 实例 GPSLocationDemo 的 运行 效果 
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该 运行 效果 所 对 应 的 布局 文件 main xml 内 容 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 

<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 


> 
<TextView 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android:text="@string/hello" 
/> 
<Button 
android: id="@+id/btn listen" 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android: text="@string/btn_listen" 
/> 
<TextView 
android:id="@+id/tv 01" 
android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:text-"" 
/> 
<TextView 
android:id="@tid/tv 02" 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android:text-"" 
/> 
</LinearLayout> 


该 布局 文件 所 使 用 的 资源 文件 strings.xml 内 容 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 

<resources> 
«string name="he11o"> 使 用 GPS 获取 位 置信 息 </string> 
<string name="app name">GPSLocation</string> 
«string name="btn_listen">akW GPS 信息 </string> 

</resources> 


实例 GPSLocationDemo 中 的 主 Activity 文件 GPSLocationActivity java 的 代码 如 下 : 


package introduction.android.gpsLocation; 


import android.app.Activity; 

import android.content.Context; 

import android. location.Location; 

import android. location.LocationListener; 
import android. location.LocationManager; 
import android.os.Bundle; 

import android.util.Log; 

import android.view.View; 

import android.view.View.OnClickListener; 


import android.widget.Button; 


346 | Android 7 应 用 程序 开发 教程 





import android.widget.TextView; 


public class GPSLocationActivity extends Activity ( 
/** Called when the activity is first created. */ 
private Button btn listen; 
private TextView tv Ol,tv 02; 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


btn listen- (Button) findViewById (R.id.btn_listen) ; 
tv 01- (TextView) findViewById (R.id.tv 01) ; 
tv 02- (TextView) findViewById (R.id.tv 02) ; 





btn listen.setOnClickListener (new OnClickListener()( 


@Override 
public void onClick (View v) { 
LocationManager locationManager= (LocationManager) 
GPSLocationActivity.this.getSystemService (Context.LOCATION SERVICE) ; 


locationManager.requestLocationUpdates (LocationManager.GPS PROVIDER, 0, 
0,new MyLocationListener()) ; 


} 
We 


class MyLocationListener implements LocationListener{ 


@Override 

public void onLocationChanged (Location location) { 
// TODO Auto-generated method stub 
tv_Ol.setText (" 您 当前 位 置 的 经 度 为 : "+location.getLongitude()) ; 
tv 02.setText ("您 当前 位 置 的 纬度 为 : "+location.getLatitude () ) ; 


@Override 

public void onProviderDisabled (String provider) { 
//4 provider 被 用 户 关闭 时 调用 
Log.i ("GpsLocation","provider 被 关闭 ! ") ; 


@Override 

public void onProviderEnabled (String provider) { 
//4 provider 被 用 户 开启 后 调用 
Log.i ("GpsLocation", "provider 被 开启 ! ") ; 


@override 
public void onStatusChanged (String provider, int status, Bundle extras) { 
//4 provider 的 状态 在 OUT OF SERVICE. TEMPORARILY UNAVAILABLE Ñl AVAILABLE 之 间 发 
生变 化 时 调用 
Log.i ("GpsLocation", "provider 状态 发 生 改变 ! ") ; 
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} 


由 以 上 代码 可 见 ， 借 助 于 Android SDK 提供 的 位 置 服务 API， 仅 仅 几 行 代码 就 可 以 实现 使 用 
GPS 定位 的 功能 。 

LocationListener 用 于 接收 位 置 发 生 改变 时 的 通知 。 当 Provider 提供 的 位 置信 息 发 生 改变 时 ， 
onLocationChanged() 方 法 会 被 调用 。 当 不 需要 使 用 LocationListener 进行 位 置 更 新 时 ， 可 以 通过 
LocationManager.removeUpdates (locationListener) 方法 将 其 移 除 。 








9.2 ”使 用 Google 地 图 服务 


9.2.1 Google Map API 简介 


Google Map 是 Google 公司 提供 的 电子 地 图 服务 ， 它 能 提供 三 种 视图 ， 分 别 是 矢量 地 图 (传统 
地 图 ) 、 俯 视 地 图 、 地 形 地 图 。 矢 量 地 图 可 以 提供 政 区 、 交 通 以 及 商业 信息 ; 俯视 地 图 可 以 提供 不 
同 分 辩 率 的 卫星 照片 ， 地 形 地 图 可 以 用 于 显示 地 形 和 等 高 线 。 

2006 年 ,Google 发 布 了 一 个 基于 Java 的 应 用 程序 Google Maps for Mobile, 可 以 用 在 Java-Based 
的 手机 上 ， 支 持 Symbian. Windows Mobile 等 移动 平台 。 在 Android 系统 推出 后 ，Google Map 服 
务 得 到 了 更 好 的 发 展 。 

2010 年 11 月 30 A, Google 宣布 ,正式 推出 最 新 版 地 图 服务 Google Earth 6, 新 版 整合 了 街景 
和 3D 技术 ， 可 为 用 户 提供 允 真 的 浏览 体验 。 新 版 本 支持 Windows. OS X 和 Linux 操作 系统 。 

近期 ，Android 版 本 的 Google Map 服务 在 其 基本 服务 的 基础 上 又 追加 了 集成 Google Offers 服 
4, 对 Google Business Photos (企业 照片 ) 服务 提供 支持 , 支持 室内 步行 导航 、 自 动 搜 寻 附 近 和 餐厅 、 
酒吧 、 加 油 站 等 详细 资料 的 功能 。 

Google Map API 是 Google 自己 推出 的 编程 API， 可 以 让 全 世界 对 Google Map 有 兴趣 的 程序 
设计 人 员 自 行 开发 基于 Google Map 的 服务 ， 建 立 自己 的 地 图 应 用 程序 。 

通过 Google Map 为 开发 者 提供 的 地 图 API 可 以 开发 出 各 种 各 样 有 趣 的 地 图 Mash-Up 应 用 ， 
还 可 以 将 不 同 地 图 图 层 加 载 到 应 用 中 ,如 卫星 影像 、 根 据 海拔 高 度 绘制 的 高 山 和 植被 地 形 图 、 街 道 
视图 等 ， 从 而 帮助 开发 者 打造 个 性 化 的 地 图 应 用 站 点 。 

Google 地 图 API 是 一 种 通过 JavaScript 将 Google HHA KAM 911] API。 该 API 提供 了 大 量 实 
用 工具 用 以 处 理 地 图 , 并 通过 各 种 服务 向 地 图 添加 内 容 ， 从 而 使 用 户 能 够 在 网 站 上 创建 功能 全 面 的 
地 图 应 用 程序 。 

Google Map API 定义 了 一 系列 用 于 在 Google Map 上 显示 、 控 制 和 层 倒 信息 的 功能 类 ， 放 置 在 
名 为 com.google.android.maps 的 包 中 。Google Map API 不 属于 Android SDK 的 标准 库 组 件 ， 需 要 
单独 下 载 。 

下 面 介绍 几 个 常用 的 类 和 接口 。 


* MapView。 用 于 显示 地 图 的 View 组 件 ， 它 派生 自 android.view.ViewGroup。 使 用 这 个 组 件 的 
时 候 必须 和 MapActivity 配合 使 用 MapView 需要 由 MapActivity 来 管理 。MapView 提供 了 3 
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种 模式 的 地 图 ， 分 别 为 交通 模式 、 卫 星 模式 、 街 景 模式 ， 分 别 可 以 通过 以 下 方式 设置 采用 什 
么 模式 来 显示 地 图 ， 代 码 如 下 : 
MapView map=new MapView (this,"Android Maps API Key") ;// 得 到 MapView 对 象 
map.setTraffic (true) ;// 设 置 为 交通 模式 
map.setSatellite (true) ;// 设 置 为 卫星 模式 
map.setStreetView (true) ;// 设 置 为 街景 模式 
* MapActivity. 用 于 显示 Google Map 的 Activity 类 , 它 是 一 个 抽象 类 , 任何 想 要 显示 MapView 
的 Activity 都 需要 派生 自 MapActivity， 并 且 在 其 派生 类 的 onCreate0 中 要 创建 一 个 MapView 
实例 。 
* MapController。 用 于 控制 地 图 的 移动 、 缩 放 等 操作 。 可 以 通过 以 下 代码 获得 MapController: 


MapController mapController=map.getController(); 


* ”Overlay。 用 于 显示 地 图 上 可 绘制 的 对 象 ， 例 如 显示 地 点 图 标 。 

* ”GeoPoint。 包 含 经 纬度 位 置 的 对 象 ， 它 可 以 实现 地 点 定位 。 要 想 实 现 一 个 简单 的 地 点 定位 ， 
首先 需要 构建 一 个 GeoPoint 来 表示 地 点 的 经 度 和 纬度 ， 然 后 使 用 animateTo 方法 将 地 图 定位 
到 GeoPoint 代表 的 经 纬度 的 地 点 ， 例 如 : 


GeoPoint geoPonit=new GeoPoint ((int) (12.5*1000000) , (int) (122.6*1000000)) ; 
mapController.animateTo (geoPonit) ; 


9.22 Rig Android Map API Key 


要 使 用 Google Map 提供 的 地 图 服务 数据 ， 必 须要 申请 一 个 Android Map API Key。 在 申请 
Android Map API Key 之 前 , 必须 要 准备 Google 的 账号 和 给 应 用 程序 签名 的 证 书 。 如 果 没 有 Google 
账号 , 可 以 到 http:/www.google.com/ 申 请 一 个 。Android 应 用 程序 发 布 时 ， 必 须 使 用 证 书 进 行 签 名 。 
在 之 前 的 开发 过 程 中 ， 虽然 一 直 没 有 涉及 证 书 的 问题 , 但 是 实际 上 , 我们 一 直 在 使 用 Android 开发 
环境 提供 的 Debug 版 本 的 证 书 来 签名 应 用 程序 。 在 调试 阶段 ， 所 有 的 应 用 程序 都 是 使 用 预定 义 的 
debug.keystore 中 的 androiddebugkey 来 签名 的 。 如 果 是 Windows XP 系统 ， 该 文件 被 存放 在 
Documents and Settings/<user>/Local Settings/Application Data/Android 目录 下 ; 如 果 是 Windows 7 
系统 ， 则 存放 在 user/<user>/.android 目录 下 。 

在 程序 调试 阶段 ， 可 以 使 用 Debug 版 的 证 书 申请 签名 密 钥 。 下 面 是 申请 Android Map API Key 
的 具体 步骤。 

€Z) 找到 自己 的 debug keystore 文件 。 


运行 cmd 命令 ， 跳 转 到 debug.keystore 所 在 目录 。 笔 者 的 计算 机 是 Windows 7 系统 ， 直 接 输入 
"cd .android”， 按 回 车 键 即 可 。 


CX302 获取 debug keystore 文件 的 MD5 值 。 
继续 在 上 一 步 的 基础 上 输入 “keytool -list -keystore debug .keystore” 命 令 ， 按 回 车 键 ， 然 后 输 


入 keystore 密码 ， 默 认 密 码 为 android， 然 后 按 回 车 键 ， 即 可 得 到 根据 调试 密 钥 生 成 的 MDS 认 
证 指纹 的 值 ， 如 图 9.3 所 示 。 该 MD5 认证 指纹 唯一 ， 读 者 在 调试 程序 时 应 该 重新 生成 自己 的 
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MDS 认证 指纹 。 

Keytool.exe 是 Java JDK 提供 的 密 钥 工 具 ， 被 放置 在 <JDK 安装 目录 >/bin 目录 下 ， 需 要 将 该 目 
录 设 置 到 Path 环境 变量 里 才能 在 CMD 窗口 中 直接 使 用 该 命名 。 参 数 -list 表示 在 CMD 窗口 中 打印 
生成 的 MDS 指纹 ，-keystore<kestore_ name> .keystore 表示 证 书 所 在 的 keystore 文件 ， 具 体操 作 如 图 
9.3 所 示 。 











BIS C:\Windows\system32\cmd.exe (on 


2011-18 


DET B6:8B:43:0D:67:FF 














图 9.3 获取 debug.keystore 的 MD5 fi 
CX303 申请 Android Map API Key. 


打开 浏览 器 ， 并 在 浏览 器 中 输入 网 址 : https://developers.google.com/android/maps-api- 
signup?hl=zh-CN, 登录 自己 的 Google 账号 , 在 申请 页 面 选择 “I have read and agree with the terms and 
conditions” 选 项 ， 然 后 输入 步骤 2 得 到 的 MDS 认证 指纹 值 ， 单 击 Generate API Key 按钮 ， 页 面 跳 
转 后 即 可 得 到 Android Map APIKey， 如 图 9.4 所 示 。 


Android Maps APIs Terms of Service ^ 
Last Updated: October 13, 2008 
Thanks for you 


APIs are a c 
"com.google.an 











ndroid Maps 
d to, the 


ndroid Maps APIs (referred to in 





VJ | have read and agree with the terms and conditions (printable version) 
My certificate's MDS fingerprint: |09:A0:B3:24:F9-1F:AD:B9:0F-9A:B6:8B:43:0D:67:FF 
Generate API Key 











图 9.4 申请 Android Map API Key 页 面 
根据 MDS 生成 的 密 钥 信息 如 图 9.5 所 示 , 并 且 提 供 了 使 用 MapView 的 示例 代码 , 将 该 代码 作 
为 一 个 组 件 复制 到 工程 的 布局 XML 文件 中 ， 就 可 以 直接 使 用 了 。 使 用 MapView 组 件 必 须 制定 
apiKey 属性 ， 若 apiKey 不 能 与 签名 密 钥 匹 配 ， 则 不 能 正常 显示 地 图 。 


























350 | Android 7 应 用 程序 开发 教程 











Google 地 图 API 
Google 代码 主页 > Google 地 图 API > Google 地 图 API 注册 





有 
您 的 密 钥 是 : 
OrvIRrEPTuYsUXACd p53h-ftI7T425PTo0jKuQ 
此 密 铀 适用 于 所 有 使 用 以 下 指纹 所 对 应 证 书 进行 验证 的 应 用 : 


09:A0:B3:24:F9:1F:AD:B9:0F:9A:B6:8B:43:0D:67:FF 





下 面 是 一 个 xml 格式 的 示例 ， 帮 助 您 了 解 地 图 功能 : 


<com.google.android.maps.MapView 
android:layout widthe"fill parent" 
android:layout height*"fill parent" 
android:apiKey-"OrvIRrEPTuYsUXACd pS3h-ft177425PT003KuQ" 
/> 


有 关 详细 信息 ， 请 查看 AP| 文档 。 


图 9.5 MD5 生成 的 密 钥 信息 





9.2.3 使 用 Google Map 显示 当前 位 置 


下 面 通 过 一 个 实例 完成 一 个 简单 的 定位 系统 ， 并 且 在 地 图 上 显示 当前 的 位 置 ， 实 例 的 详细 代 
码 在 GPSLocationInMapDemo 项 目 中 ， 实 际 调试 时 需要 在 真 机 上 进行 并 且 需 要 开启 GPS。 运 行 效 
果 如 图 9.6 所 示 。 


| SPsLocationinMapDemo 


North” 
X Korea 


m Japan 
South Korea 





图 9.6 一 个 简单 的 定位 系统 
具体 步骤 如 下 : 


ED 创建 一 个 新 的 工程 并 命名 为 GPSLocationIhMapDemo， 需 要 注意 的 是 ， 由 于 要 使 用 
Google Map API, 因此 创建 的 主 Activity 需要 继承 自 MapActivity, MAE Activity. 当选 择 Build Target 
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时 ， 应 选择 Google APIs, WE 9.7 Fim. 





Pr 








Select Build Target 
Choose an SDK to target 








Buid Target 














Target Name Vendor Platform API 
| [E Android 4.0 Android Open Source Project 40 14 | 
团 Google APis Google Inc. 40 14 





Android + Google APIs 









































图 9.7 New Andriod Project 对 话 框 
人 2 在 AndroidManifest.xml 文件 中 的 <application> 标 签 中 加 入 : 


<uses-library android:name="com.google.android.maps" /> 


以 便 可 以 使 用 Google Map API。 为 了 使 用 GPS 数据 ， 在 <application> 标 签 之 外 加 入 如 下 权限 : 


<uses-permission android:name="android.permission.ACCESS FINE LOCATION" /> 


为 了 从 Intemet 获取 地 图 数据 ， 需 要 网 络 访问 权限 : 


<uses-permission android:name="android.permission.INTERNET"/> 


CX308 编写 main xml 布局 文件 ， 具 体 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 


<LinearLayout xmlns:android="http://schemas. android. com/apk/res/android" 


android: layout_width="fill parent" 
android: layout_height="fill parent" 
android: orientation="vertical"> 


<TextView 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android:text="@string/hello" /> 
<TextView 
android: id="@+id/myLocationText" 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
1> 
<com.google.android.maps .MapView 
android:id="@+id/myMapView" 
android: layout_width="fill parent" 
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android: layout_height="fill parent" 
android:apiKey-"ÜrvIRrEPTuYsUXACd p53h-ftl7T425PTo0jKuQ" 
android:clickable-"true" /» 

</LinearLayout> 


在 main.xml 布局 中 放置 了 两 个 TextView 和 一 个 MapView 组 件 。 
GPSLocationInMapDemoActivity java 的 代码 如 下 : 


package introduction.android.gpsLocationInMapDemo; 


import android.content.Context; 

import android. location.Location; 

import android. location.LocationListener; 
import android. location.LocationManager; 
import android.os.Bundle; 

import android.widget.TextView; 

import com.google.android.maps.GeoPoint; 
import com.google.android.maps.MapActivity; 
import com.google.android.maps.MapController; 
import com.google.android.maps.MapView; 
import com.google.android.maps.MyLocationOverlay; 


public class GPSLocationInMapDemoActivity extends MapActivity { 
/** Called when the activity is first created. */ 
// %€X Location 对 象 
protected Location location; 
// 定义 MapView MR 
private MapView map; 
// 定义 MyLocationOverlay 对 象 ， 在 地 图 上 标注 当前 位 置 
private MyLocationOverlay myLocation; 
private MapController mapController; 
private TextView myLocationText; 
private GeoPoint geopoint; 
private double latitude; 
private double longitude; 


/** Called when the activity is first created. */ 
protected boolean isRouteDisplayed() { 
return false; 


public void onCreate (Bundle savedInstanceState) { 

super.onCreate (savedInstanceState) ; 

setContentView (R.layout.main) ; 

myLocationText- (TextView) findViewById (R.id.myLocationText) ; 

// S&X LocationManager 对 象 

LocationManager locationManager; 

String seviceName-Context.LOCATION SERVICE; 

// 获取 LocationManager WR 

locationManager= (LocationManager) getSystemService (seviceName) ; 
locationManager. requestLocationUpdates (LocationManager.GPS 
2000, 10, locationListener) ; 

// 得 到 MapView HR 

map= (MapView) findViewById (R.id.myMapView) ; 

// 得 到 MapView 对 象 的 控制 器 


PROVIDER, 
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mapController-map.getController () ; 
// 设置 map 支持 缩放 工具 条 
map.setBuiltInZoomControls (true) ; 
map.setSatellite (true) ; 

5 


// 得 到 LocationListener WR 
private final LocationListener locationListener-new LocationListener () { 
// *4 Provider 处 于 不 能 使 用 时 触发 
public void onProviderDisabled (String provider) { 
i} 
// 当 状态 发 生 改 变 时 触发 


public void onStatusChanged (String provider, int status, Bundle extras) { 
5 


// 当 位 置 发 生变 化 时 触发 
@Override 
public void onLocationChanged (Location location) { 
// TODO Auto-generated method stub 
// 得 到 当前 位 置 的 纬度 
latitude-location.getLatitude(); 
// 得 到 当前 位 置 的 经 度 
longitude-location.getLongitude(); 
geopoint-new GeoPoint (new Double (latitude * 1E6) .intValue(), 
new Double (longitude * 1E6) .intValue()) ; 


mapController.setCenter (geopoint) ; 
// 得 到 当前 位 置 的 MyLocationOverlay 对 象 
myLocation=new MyLocationOverlay ( 
GPSLocationInMapDemoActivity.this, map) ; 
myLocation.enableMyLocation(); 
// 将 当前 位 置 添加 到 地 图 上 
map.getOverlays () .add (myLocation) ; 
// 设置 地 图 为 卫星 模式 
myLocationText.setText (" 当 前 位 置 纬度 : "+latitude+"\n 当前 位 置 经 度 : " 
+longitude) ; 
} 
// 当 Provider 处 于 可 用 时 触发 
@Override 
public void onProviderEnabled (String provider) { 
// TODO Auto-generated method stub 


该 实例 中 获取 GPS 经 纬度 数据 的 过 程 和 上 一 节 中 完全 相同 ， 在 此 不 再 描述 。MapView 组 件 通 
过 网 络 载 入 所 需 地 图 ， 并 且 提 供 了 拖 忠 地 图 的 接口 ， 用 户 可 以 直接 在 MapView 中 移动 地 图 。 
MapView 提供 了 地 图 控制 器 ， 通 过 


mapController=map.getController (); 


方法 可 以 获取 到 。 通 过 控制 器 可 以 方便 地 控制 MapView 组 件 中 地 图 的 缩放 和 窗口 移动 。 本 实例 中 


mapController.setCenter (geopoint) 
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控制 器 将 当前 位 置 geopoint 设置 为 MapView 组 件 的 中 心 。GeoPoint 代表 的 是 地 图 上 特定 的 点 ， 需 
要 注意 的 是 , 在 MapView 中 使 用 的 geoPoint 的 经 纬度 位 置 与 从 GPS 中 获取 的 经 纬度 存在 一 个 1E6 
的 比例 差 ， 需 要 经 过 转换 后 才能 正确 显示 当前 位 置 。 本 实例 中 的 坐标 转换 代码 为 : 


latitude-location.getLatitude(); 

longitude-location.getLongitude|(); 

geopoint-new GeoPoint (new Double (latitude * 1E6) .intValue(), 
new Double (longitude * 1E6) .intValue()) ; 


MapView 提供 了 更 加 方便 地 对 地 图 数据 进行 缩放 的 方式 ， 通 过 
map.setBuiltInZoomControls (true) ; 


在 地 图 上 放置 一 个 缩放 条 (如 图 9.8 所 示 ) ， 用 户 可 以 直接 使 用 该 缩放 条 对 地 图 进行 放大 和 缩小 ， 
而 无 须 编写 任何 代码 。 








图 9.8 缩放 条 























Overlay 是 Google Map API 提供 的 专门 在 地 图 上 进行 iano E) 
标记 的 类 。 本 实例 中 使 用 Overlay 标记 当前 的 位 置 点 。 相关 | ues 
代码 为 : Target | Google APIs (Google Inc) - API Level 14 =] 

// 得 到 当前 位 置 的 MyLocationoverlay MR Sore n 

myLocation-new MyLocationOverlay ( Sn Cut : 

GPSLocationInMapDemoActivity.this, map) ; (ios) 
myLocation.enableMyLocation(); | Mi je 

// 将 当前 位 置 添加 到 地 图 上 | snapshot 

map.getOverlays().add (myLocation) ; Enabled! 

|| Skin: 

至 此 ， 该 实例 开发 完成 。 运 行 该 实例 需要 支持 Google | suis [aver 3) 
APIs 的 AVD, WE 9.9 所 示 。 若 没有 ， 则 可 以 通过 AVD serons d 
Manager 创建 一 个 。 UU valve (ews) 

Abstracted LCD density 160 
Max VM application h~ 24 P 
Device ram size 256 
93 fe 感 器 
Override the existing AVD with the same name 
H Ac I 
9.3.1 Android 传感器 简介 | je 
J 












































大 部 分 的 Android 设备 都 带 有 内 建 的 用 于 测量 运动 、 图 9.9 创建 支持 Google APIs 的 AVD 
方位 以 及 各 种 环境 条 件 的 传感器 。 这 些 传感器 能 够 提供 高 
精度 、 高 准确 性 的 原始 数据 ， 当 用 户 需要 监控 设备 的 三 维 运 动 和 位 置 或 者 监控 周围 条 件 的 变换 时 ， 
这 些 传 感 器 很 有 效 。 举 例 来 讲 , 一 个 游戏 可 以 通过 不 断 读 取 设 备 的 重力 传感器 的 方式 推断 用 户 的 动 
作 和 运动 ， 如 倾斜 、 摇 晃 、 旋 转 、 摆 动 等 ;一 个 天 气相 关 的 应 用 程序 可 以 通过 设备 的 温度 传感器 和 
湿度 传感器 计算 并 报告 露水 情况 ; 一 个 旅游 相关 的 应 用 程序 可 以 根据 地 磁 传 感 器 和 加 速 传感器 模拟 
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一 个 罗盘 。 

总 的 来 讲 ，Android 平台 支持 三 种 类 型 的 传感器 。 

e 运动 传感器 (Motion Sensors): 这 种 类 型 的 传感器 用 于 在 三 维 方向 测量 加 速 力 和 旋转 力 ， 包 
括 加 速度 传感器 、 重 力 传感器 、 陀 螺 仪 和 旋转 向 量 传感器 等 。 

© 环境 传感器 (Environmental Sensors): 这 种 类 型 的 传感器 用 于 测量 各 种 环境 参量 ， 如 环境 温 
度 、 气 压 和 湿度 等 ， 例 如 气压 计 、 光 度 计 和 温度 计 等 。 

© ”位 置 传感器 (Position Sensors); 这 种 类 型 的 传感器 用 于 测量 设备 的 物理 位 置 ， 包 括 方向 传 感 
器 和 磁力 计 等 。 

开发 者 可 以 访问 设备 上 支持 的 传感器 ， 并 且 通 过 Android 传感器 框架 获取 相关 的 原始 数据 。 
Android 传感器 框架 提供 几 个 类 和 接口 帮助 开发 者 开发 完成 与 传感器 相关 的 各 种 任务 。 例 如 ， 可 以 
使 用 传感器 框架 完成 如 下 任务 : 

o 获取 当前 设备 支持 的 传感器 类 型 。 

© 获取 某 个 传感器 的 具体 信息 ， 例 如 最 大 范围 、 生 产 商 、 功 耗 和 分 辨 率 等 。 

© 从 传感器 获取 原始 信息 以 及 获取 信息 的 频率 。 

e 注册 或 者 注销 用 于 监测 传感器 变化 的 监听 器 。 

Android 的 传感器 框架 允许 开发 者 访问 当前 设备 上 各 种 类 型 的 传感器 ,包括 硬件 传感器 和 软件 
传感器 。 硬件 传感器 指 内 建 在 Android 设备 中 的 硬件 部 分 , 它们 直接 测量 具体 数据 并 传递 给 应 用 程 
序 。 软 件 传感器 不 是 以 硬件 方式 存在 于 设备 中 的 , 而 是 软件 模拟 出 来 的 ， 因此 又 叫 虚拟 传感器 或 者 
合成 传感器 。 它们 的 数据 来 自 一 个 或 者 多 个 硬件 传感器 。 线性 加 速度 传感器 和 重力 传感器 是 典型 的 
软件 传感器 。 

表 9.5 所 示 为 Android 平台 支持 的 所 有 的 传感器 类 型 。 


表 9.5 Android 平台 支持 的 传感器 类 型 























传感器 
TYPE_ACCELEROMETER 
TYPE AMBIENT TEMPERATURE 监控 环境 温度 

TYPE_GRAVITY 软件 或 者 硬件 传感器 运动 探测 

TYPE_GYROSCOPE 硬件 传感器 旋转 探测 

TYPE LIGHT 硬件 传感器 控制 屏幕 亮度 

TYPE LINEAR ACCELERATION 
TYPE MAGNETIC FIELD 硬件 传感器 创建 罗盘 

TYPE_ORIENTATION 软件 传感器 探测 设备 方位 

TYPE PRESSURE 硬件 传感器 探测 空气 压力 变化 

TYPE PROXIMITY 硬件 传感器 用 于 监测 打 电 话 时 手机 与 耳 条 的 距离 
TYPE RELATIVE HUMIDITY 硬件 传感器 探测 结 露点 、 相 对 和 绝对 湿度 

TYPE ROTATION VECTOR 软件 或 者 硬件 传感器 运动 检测 和 旋转 检测 








TYPE TEMPERATURE 硬件 传感器 探测 温度 


以 上 传感器 类 型 在 Android N 系统 中 都 获得 了 支持 ， 但 是 TYPE ORIENTATION 和 
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TYPE TEMPERATURE 两 种 类 型 已 经 被 弃 用 。 


如 果 应 用 程序 要 被 发 布 在 Google Play 上 ， 则 可 以 通过 应 用 程序 的 Manifest 配置 文件 中 的 





<uses=features> 属 性 来 设置 应 用 程序 的 发 布 对 象 。 例 如 以 下 代码 : 


9.3 


T: 


获取 


<uses-feature android:name="android.hardware.sensor.accelerometer” 
android:required-"true" /> 


可 以 保证 应 用 程序 只 能 被 带 有 加 速度 传感器 的 手机 设备 搜索 到 。 

Android 传感器 框架 存放 在 android.hardware 包 中 ， 主 要 涉及 以 下 几 个 类 和 接口 。 

* SensorManager: 这 个 类 被 用 于 创建 传感器 服务 实例 。 该 类 提供 了 访问 和 罗列 传感器 的 各 种 方 
法 ， 用 于 注册 和 注销 传感器 事件 监听 器 并 获取 方向 信息 。 该 类 也 提供 了 几 个 常量 ， 用 于 报告 
传感器 的 精度 、 数 据 获 取 率 和 校正 传感器 。 

* Sensor: 这 个 类 被 用 作 创建 某 个 特定 传感器 的 实例 。 该 类 提供 了 用 于 确定 传感器 能 力 的 各 种 
© SensorEvent: 该 类 被 用 作 创建 传感器 事件 对 象 。 传感器 事件 对 象 包含 传感器 事件 的 相关 信息 ， 
包括 原始 的 传感器 数据 、 传 感 器 类 型 、 产 生 的 事件 、 事 件 精 度 以 及 事件 发 生 的 时 间 蕉 等 。 
© SensorEventListener: 该 接口 包含 两 个 回调 方法 。 当 传感器 的 值 发 生 改 变 或 者 传感器 的 精度 发 

生 改 变 时 ， 相 关 方法 就 会 自动 被 调用 。 
通过 传感器 框架 API， 开 发 者 主要 可 以 完成 两 件 事 : 


e 识别 传感器 并 且 明 确 传感器 功能 。 
e 监听 传感器 事件 并 进行 处 理 。 


.2 ”标识 传感器 
识别 传感器 的 工作 要 通过 SensorManager 类 的 实例 来 完成 。 获 取 SensorManager 实例 的 代码 如 


private SensorManager mSensorManager; 


mSensorManager- (SensorManager) getSystemService (Context.SENSOR SERVICE) ; 


通过 SensorManager 获取 当前 设备 的 传感器 列表 的 代码 如 下 : 


List«Sensor»deviceSensors-mSensorManager.getSensorList (Sensor.TYPE ALL) ; 


要 获取 特定 类 型 的 传感器 实例 ， 使 用 SensorManager.getDefaultSensor() 方 法 。 以 下 代码 演示 了 
磁场 传感器 的 方法 : 


if (mSensorManager.getDefaultSensor (Sensor.TYPE MAGNETIC FIELD) !=null) { 
// Success! There's a magnetometer. 
} 

else { 
// Failure! No magnetometer. 


) 
以 下 示例 代码 演示 了 获取 当前 设备 的 重力 传感器 的 过 程 。 要 求 重力 传感器 的 销售 商 是 “Google 
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Inc.”， 如 果 满 足 该 条 件 的 传感器 不 存在 ， 则 尝试 使 用 加 速度 传感器 : 


private SensorManager mSensorManager; 


private Sensor mSensor; 


mSensorManager= (SensorManager) getSystemService (Context.SENSOR SERVICE) ; 





if (mSensorManager.getDefaultSensor (Sensor.TYPE GRAVITY) !-null) ( 
List«Sensor»gravSensors-mSensorManager.getSensorList (Sensor.TYPE GRAVITY) ; 
for (int i-0; i«gravSensors.size(); i++) { 
if ((gravSensors.get (i) .getVendor().contains ("Google Inc.")) && 
(gravSensors.get (i) .getVersion()==3)) { 
// Use the version 3 gravity sensor. 
mSensor-gravSensors.get (i) ; 


} 


} 
else{ 
// Use the accelerometer. 
if (mSensorManager.getDefaultSensor (Sensor.TYPE ACCELEROMETER) !-null) { 
mSensor-mSensorManager.getDefaultSensor (Sensor. TYPE_ACCELEROMETER) ; 
) 
else( 
// Sorry, there are no accelerometers on your device. 
// You can't play this game. 


9.3.3 传感器 事件 处 理 


传感器 事件 监听 器 接口 提供 两 个 方法 : onAccuracyChanged0 和 onSensorChanged() 方 法 ， 分 别 
对 传感器 的 精度 改变 和 传感器 的 数值 改变 事件 进行 处 理 。 
以 下 代码 演示 了 从 光敏 传感器 获取 数据 的 过 程 : 


public class SensorActivity extends Activity implements SensorEventListener { 
private SensorManager mSensorManager; 
private Sensor mLight; 


@Override 

public final void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


mSensorManager- (SensorManager) getSystemService (Context.SENSOR SERVICE) ; 
mLight-mSensorManager.getDefaultSensor (Sensor.TYPE LIGHT) ; 
} 


&Override 
public final void onAccuracyChanged (Sensor sensor, int accuracy) ( 


// Do something here if sensor accuracy changes. 
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@Override 

public final void onSensorChanged (SensorEvent event) { 
// The light sensor returns a single value. 
// Many sensors return 3 values, one for each axis. 
float lux-event.values [0]; 
// Do something with this sensor value. 


) 


@Override 
protected void onResume() { 
super.onResume () 7 
mSensorManager.registerListener (this, mLight, SensorManager.SENSOR DELAY NORMAL) ; 


} 


@Override 
protected void onPause() { 
super.onPause(); 
mSensorManager.unregisterListener (this) ; 
} 
) 


Hp: 


@Override 
protected void onPause() { 
super.onPause() ; 
mSensorManager.unregisterListener (this) ; 


) 
这 几 行 代码 是 很 有 必要 的 。 如 果 当 Activity 暂停 的 时 候 ， 传 感 器 的 事件 监听 器 没有 被 注销 ， 则 


该 监听 器 还 会 一 直 从 传感器 获取 信息 ， 这 样 会 耗费 大 量 的 电力 。 因 此 ， 当 Activity 暂停 时 ， 一 定 要 
使 用 上 述 代码 在 onPause() 方 法 中 注销 对 传感器 事件 的 监听 。 当 Activity 再 次 被 激活 时 ,在 onResume() 
方法 中 使 用 SensorManagerregisterListener() 方 法 重新 注册 传感器 事件 监听 器 。 


mSensorManager.registerListener (this, mLight, SensorManager.SENSOR DELAY NORMAL) ; 


表示 注册 的 传感器 事件 监听 器 为 当前 类 的 实例 ， 被 监听 的 传感器 为 mLight， 获 取 数 据 的 频率 


为 SENSOR DELAY NORMAL. 


9.4 运动 传感器 


目前 ，Android 平台 支持 的 运动 传感器 包括 以 下 5 种 : 


TYPE ACCELEROMETER, 
TYPE GRAVITY. 

TYPE GYROSCOPE, 

TYPE LINEAR. ACCELERATION. 
TYPE ROTATION VECTOR. 
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本 节 将 对 这 几 种 传感器 的 用 法 做 简单 介绍 。 


9.4.1 加 速度 传感器 


获取 加 速度 传感器 实例 的 代码 如 下 : 


private SensorManager mSensorManager; 

private Sensor mSensor; 

mSensorManager= (SensorManager) getSystemService (Context.SENSOR_SERVICE) ; 
mSensor-mSensorManager.getDefaultSensor (Sensor.TYPE ACCELEROMETER) ; 


从 传感器 获取 数据 并 计算 三 个 方向 的 加 速度 的 代码 如 下 : 


public void onSensorChanged (SensorEvent event) { 
// In this example, alpha is calculated as t / (t+dT) , 
// where t is the low-pass filter's time-constant and 
// dT is the event delivery rate. 


final float alpha-0.8; 


// Isolate the force of gravity with the low-pass filter. 

gravity[0]-alpha * gravity[0]+ (1 - alpha) * event.values[0]; 
gravity[1]-alpha * gravity[1]+ (1 - alpha) * event.values[1]; 
gravity[2]-alpha * gravity[2]+ (1 - alpha) * event.values[2]; 


// Remove the gravity contribution with the high-pass filter. 
linear acceleration[0]-event.values[0] - gravity[0]; 
linear acceleration[l]-event.values[1] - gravity[1]; 
linear acceleration[2]-event.values[2] - gravity[2]; 


) 
该 计算 方法 仅 是 举例 使 用 ， 实 际 计算 方法 要 针对 应 用 而 确定 。 


94.2 ”重力 传感器 


重力 传感器 是 加 速度 传感器 的 一 种 ， 其 数据 处 理 方式 也 相似 。 此 处 不 再 重复 重力 传感器 的 数 


据 计 算 方法 。 获 取 重 力 传感器 的 代码 如 下 


private SensorManager mSensorManager; 

private Sensor mSensor; 

mSensorManager- (SensorManager) getSystemService (Context.SENSOR SERVICE) ; 
mSensor-mSensorManager.getDefaultSensor (Sensor.TYPE GRAVITY) ; 


943 PEIRIN 


陀螺 仪 可 以 在 三 个 维度 上 测量 设备 的 旋转 情况 。 获 取 陀 螺 仪 传感器 的 代码 如 下 : 


private SensorManager mSensorManager; 


private Sensor mSensor; 


360 


| Android 7 应 用 程序 开发 教程 





mSensorManager- (SensorManager) getSystemService (Context.SENSOR SERVICE) ; 
mSensor-mSensorManager.getDefaultSensor (Sensor.TYPE GYROSCOPE) ; 


从 陀螺 仪 数 据 计算 三 个 维度 旋转 情况 的 代码 如 下 : 


// Create a constant to convert nanoseconds to seconds. 
private static final float NS2S=1.0f / 1000000000.0f; 
private final float[] deltaRotationVector=new float[4] (); 
private float timestamp; 


public void onSensorChanged (SensorEvent event) { 


// This timestep's delta rotation to be multiplied by the current rotation 
// after computing it from the gyro sample data. 
if (timestamp !=0) { 

final float dT= (event.timestamp - timestamp) * NS2S; 

// Axis of the rotation sample, not normalized yet. 

float axisX-event.values[0]; 

float axisY=event.values[1]; 

float axisZ=event.values[2]; 


// Calculate the angular speed of the sample 
float omegaMagnitude-sqrt (axisX*axisX+axisY*axisYt+axisZ*axisZ) ; 


// Normalize the rotation vector if it's big enough to get the axis 
// (that is, EPSILON should represent your maximum allowable margin of error) 
if (omegaMagnitude>EPSILON) { 
axisX /=omegaMagnitude; 
axisY /=omegaMagnitude; 
axisZ /=omegaMagnitude; 
} 


// Integrate around this axis with the angular speed by the timestep 
// in order to get a delta rotation from this sample over the timestep 
// We will convert this axis-angle representation of the delta rotation 
// into a quaternion before turning it into the rotation matrix. 

float thetaOverTwo-omegaMagnitude * dT / 2.0f; 

float sinThetaOverTwo-sin (thetaOverTwo) ; 

float cosThetaOverTwo-cos (thetaOverTwo) ; 
deltaRotationVector[0]-sinThetaOverTwo * axisX; 
deltaRotationVector[1]-sinThetaOverTwo * axisY; 
deltaRotationVector[2]-sinThetaOverTwo * axisZ; 
deltaRotationVector[3]-cosThetaOverTwo; 

ib 

timestamp-event.timestamp; 

float[] deltaRotationMatrix-new float[9]; 

SensorManager.getRotationMatrixFromVector (deltaRotationMatrix, deltaRotationVector) ; 
// User code should concatenate the delta rotation we computed with the current rotation 
// in order to get the updated rotation. 

// rotationCurrent-rotationCurrent * deltaRotationMatrix; 


} 
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9.4.4 ”线性 加 速度 传感器 


线性 加 速度 传感器 是 传感器 的 一 种 。 其 获取 实例 的 代码 如 下 : 


private SensorManager mSensorManager; 
private Sensor mSensor; 


mSensorManager= (SensorManager) getSystemService (Context.SENSOR_SERVICE) ; 
mSensor-mSensorManager.getDefaultSensor (Sensor.TYPE LINEAR ACCELERATION) ; 


9.4.5 “旋转 向 量 传感器 
旋转 向 量 传感器 能 反映 出 当前 设备 的 状态 ， 其 返回 值 是 旋转 角度 与 旋转 轴 的 集合 。 获 取 旋 转 
向 量 传感器 实例 的 相关 代码 如 下 : 


private SensorManager mSensorManager; 
private Sensor mSensor; 


mSensorManager- (SensorManager) getSystemService (Context.SENSOR SERVICE) ; 
mSensor=mSensorManager.getDefaultSensor (Sensor.TYPE ROTATION VECTOR) ; 


本 节 仅 是 对 运动 传感器 的 使 用 做 简单 介绍 。 要 深入 了 解 这 些 传感器 ， 读 者 可 参阅 相关 文档 。 
一 A 
9.5 位置 传感器 


Android 平台 支持 的 位 置 传感器 主要 有 三 种 : 


e TYPE MAGNETIC FIELD. 
e TYPE ORIENTATION. 
e TYPE PROXIMITY. 


下 面 对 这 三 种 传感器 做 简单 介绍 。 


9.5.1 磁场 传感器 
磁场 传感器 用 于 测量 地 球 磁场 的 强度 。 获 取 磁 场 传感器 实例 的 代码 如 下 : 


private SensorManager mSensorManager; 
private Sensor mSensor; 


mSensorManager= (SensorManager) getSystemService (Context.SENSOR_SERVICE) ; 
mSensor-mSensorManager.getDefaultSensor (Sensor.TYPE MAGNETIC FIELD) ; 


磁场 传感器 获取 的 原始 数据 记录 的 是 在 三 个 方向 上 地 球 磁场 的 强度 。 通 常情 况 下 ， 这 些 数据 
并 不 会 直接 使 用 ， 而 是 和 旋转 向 量 传感器 、 加 速度 传感器 的 数据 一 起 用 于 计算 设备 的 位 置 数据 。 
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9.5.2 方位 传感器 


方位 传感器 用 于 监测 设备 相对 于 地 球 坐标 系 的 位 置 。 方 位 传感器 从 Android 2.2 (API Level 8) 
就 被 淘汰 ， 在 之 后 的 设备 上 的 访问 传感器 都 是 软件 传感器 。 
获取 方位 传感器 实例 的 代码 如 下 : 


private SensorManager mSensorManager; 

private Sensor mSensor; 

mSensorManager= (SensorManager) getSystemService (Context.SENSOR_SERVICE) ; 
mSensor-mSensorManager.getDefaultSensor (Sensor. TYPE ORIENTATION) ; 


以 下 代码 演示 了 从 方位 传感器 获取 数据 的 过 程 : 


public class SensorActivity extends Activity implements SensorEventListener { 


private SensorManager mSensorManager; 
private Sensor mOrientation; 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


mSensorManager- (SensorManager) getSystemService (Context.SENSOR SERVICE) ; 
mOrientation-mSensorManager.getDefaultSensor (Sensor.TYPE ORIENTATION) ; 


@Override 

public void onAccuracyChanged (Sensor sensor, int accuracy) { 
// Do something here if sensor accuracy changes. 
// You must implement this callback in your code. 


@Override 
protected void onResume() { 

super.onResume () ; 

mSensorManager.registerListener (this, mOrientation, SensorManager.SENSOR DELAY NORMAL); 
} 


@Override 

protected void onPause() { 
super.onPause(); 
mSensorManager.unregisterListener (this) ; 


} 


@Override 

public void onSensorChanged (SensorEvent event) { 
float azimuth_angle=event.values[0]; 
float pitch angle-event.values[1]; 
float roll angle-event.values[2]:; 


// Do something with these orientation angles. 
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9.53 ”距离 传感器 


距离 传感器 用 于 探测 Android 设备 与 其 他 物体 的 距离 , 例如 手机 与 耳 休 的 距离 。 获 取 距 离 传 感 
器 实例 的 代码 如 下 : 


private SensorManager mSensorManager; 
private Sensor mSensor; 


mSensorManager= (SensorManager) getSystemService (Context.SENSOR_SERVICE) ; 
mSensor-mSensorManager.getDefaultSensor (Sensor.TYPE PROXIMITY) ; 


下 列 代码 演示 了 使 用 距离 传感器 的 方法 : 


public class SensorActivity extends Activity implements SensorEventListener { 
private SensorManager mSensorManager; 
private Sensor mProximity; 


@Override 

public final void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


// Get an instance of the sensor service, and use that to get an instance of 
// a particular sensor. 

mSensorManager- (SensorManager) getSystemService (Context.SENSOR SERVICE) ; 
mProximity-mSensorManager.getDefaultSensor (Sensor.TYPE PROXIMITY) ; 


@Override 
public final void onAccuracyChanged (Sensor sensor, int accuracy) { 
// Do something here if sensor accuracy changes. 


@Override 

public final void onSensorChanged (SensorEvent event) { 
float distance=event.values [0]; 
// Do something with this sensor data. 


@Override 
protected void onResume() { 
// Register a listener for the sensor. 
super.onResume () 7 
mSensorManager.registerListener (this, mProximity, SensorManager.SENSOR DELAY NORMAL) ; 


} 


gOverride 

protected void onPause() { 
// Be sure to unregister the sensor when the activity pauses. 
super.onPause(); 
mSensorManager.unregisterListener (this) ; 


} 


364 | Android 7 应 用 程序 开发 教程 





96 ”环境 传感器 


Android 平台 支持 的 环境 传感器 有 如 下 几 种 : 


TYPE_AMBIENT TEMPERATURE. 
TYPE LIGHT, 

TYPE PRESSURE. 

TYPE RELATIVE HUMIDITY. 
TYPE TEMPERATURE, 


下 列 示 例 代 码 演示 了 使 用 压力 传感器 测量 大 气 气压 的 方法 ， 其 他 环境 传感器 的 使 用 方法 相同 ， 
在 此 不 再 一 一 描述 : 


public class SensorActivity extends Activity implements SensorEventListener { 
private SensorManager mSensorManager; 


private Sensor mPressure; 


@Override 

public final void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 


// Get an instance of the sensor service, and use that to get an instance of 
// a particular sensor. 

mSensorManager- (SensorManager) getSystemService (Context.SENSOR SERVICE) ; 
mPressure-mSensorManager.getDefaultSensor (Sensor.TYPE PRESSURE) ; 


@Override 
public final void onAccuracyChanged (Sensor sensor, int accuracy) { 
// Do something here if sensor accuracy changes. 


@Override 

public final void onSensorChanged (SensorEvent event) { 
float millibars of pressure-event.values[0]; 
// Do something with this sensor data. 


@Override 
protected void onResume() { 
// Register a listener for the sensor. 
super.onResume () + 
mSensorManager.registerListener (this, mPressure, SensorManager.SENSOR DELAY NORMAL) ; 


) 


gOverride 
protected void onPause() { 
// Be sure to unregister the sensor when the activity pauses. 


super.onPause () + 
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mSensorManager.unregisterListener (this) ; 


} 
} 


97 小 结 


本 章 主要 讲解 了 位 置 服务 的 相关 内 容 ， 介 绍 了 和 位 置 服务 相关 的 类 和 接口 的 功能 。 

借助 于 Google Map API, 可 以 方便 地 实现 位 置 服务 应 用 程序 。 需 要 注意 的 是 , Google Map API 
并 不 是 Android SDK 自 带 的 包 ， 需要 额外 配置 ， 其 调试 程序 所 使 用 的 AVD 和 之 前 的 不 同 ， 需 要 支 
持 Google APIs， 其 主 Activity 必须 继承 自 MapActivity， 而 不 是 Activity。 通 过 MapView 类 的 对 象 
可 以 从 网 络 下 载 Google Map 数据 ， 供 我 们 自己 的 应 用 程序 使 用 ， 但 是 使 用 MapView 组 件 必须 指 
定 其 apiKey 属性 ， 否 则 不 能 正常 运行 。apiKey 必须 与 应 用 程序 的 签名 密 钥 相 匹配 ， 本 章 也 介绍 了 
在 Google 网 站 使 用 Debug 密 钥 申请 对 应 的 apiKey 的 方法 。 

本 章 的 实例 中 进行 定位 时 ， 为 了 便于 使 用 AVD 调试 应 用 程序 ， 使 用 的 都 是 GPS 定位 方式 。 
若 要 使 用 网 络 定位 方式 ， 则 只 需要 将 LocationManager.GPS PROVIDER 修改 为 
LocationManagerNETWORK PROVIDER 即 可 ， 其 他 代码 不 需要 改变 。 

位 置 服务 应 用 程序 是 Android 移动 设备 的 特色 服务 , 有 很 大 的 市 场 。 希 望 本 章 的 简单 范例 程序 
能 将 读者 引入 位 置 服务 应 用 程序 开发 之 路 。 

本 章 对 传感器 编程 进行 了 简单 的 介绍 。Android 平台 支持 多 种 传感器 ， 通 过 传感器 可 以 获取 数 
据 ， 各 种 传感器 的 编程 方式 基本 相同 ， 易 于 读者 掌握 。 活 用 传感器 可 以 开发 出 极 具 感 染 力 的 应 用 程 
序 ， 传 感 器 已 被 越 来 越 多 地 应 用 于 Android 系统 中 手机 游戏 的 开发 。 


98 习 题 


. 练习 Overlay， 在 地 图 上 使 用 图 片 标注 一 个 地 点 。 

. 为 MapView 开发 自己 的 地 图 缩放 工具 条 。 

. 为 MapView 开发 自己 的 地 图 浏览 工具 条 。 

. 通过 Criteria 查找 免费 的 、 高 精度 的 LocationProvider。 

. 尝试 开发 一 个 自动 调节 屏幕 亮度 的 应 用 程序 。 

. 尝试 开发 一 个 无 论 手机 是 否 颠倒 ， 都 可 以 使 图 片 正 向 显示 的 图 片 查看 程序 。 














Aunt wn 一 


Android 系统 提供 了 非常 强大 的 图 形 处 理 能 力 .Android 系统 对 于 2D 图 形 的 处 理 采 用 自 定 义 的 
一 系列 2D 图 形 处 理 类 ， 而 没有 使 用 Java IDK 提供 的 图 形 处 理 类 。 这 些 自 定义 的 类 分 别 位 于 
android.graphics、android.graphics.drawable.shapes 和 android.view.animation 包 中 。 而 对 3D 图 形 进 
行 处 理 的 类 分 别 位 于 javax.microedition.khronos.opengles 和 android. opengl 包 中 。 

Android 系统 中 的 图 形 处 理 基本 可 以 分 为 两 类 ， 一 类 是 针对 不 经 常 变 化 的 图 像 ， 即 静态 图 形 处 
理 ， 另 一 类 是 针对 经 常 变 化 的 图 像 ， 即 动态 图 形 处 理 。 


10.1 2D 绘图 


Android API 提供 一 系列 进行 2D 绘图 的 方法 ， 被 放置 在 android.graphics.drawable 包 下 。 通 常 
有 两 种 2D 绘图 的 方法 : 
o ”在 布局 文件 定义 的 View 组 件 中 进行 绘图 。 绘 图 工作 由 系统 的 绘制 进程 管理 ， 开 发 者 只 需 绘 
制图 形 即 可 。 这 种 方式 适合 绘制 不 需要 实时 更 新 的 静态 图 像 。 
e 在 Canvas 中 绘图 。 这 种 方式 需要 由 开发 者 自己 调用 onDraw0 方 法 来 对 图 像 进行 绘制 。 当 图 
像 需要 定时 更 新 时 最 好 使 用 这 种 方式 ， 适 合 动画 绘制 和 视频 游戏 开发 。 


10.1.1 获取 Canvas WR 


要 在 Android 系统 下 绘制 图 形 ， 需 要 4 个 基本 组 件 ， 分 别 说 明 如 下 。 
* Bitmap: 相当 于 画布 ， 用 于 管理 像素 。 
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e Canvas 相当 于 在 Bitmap 上 绘图 的 画家 ， 用 于 管理 绘制 过 程 ， 提 供 绘图 方法 。 
* Drawable: 绘制 要 素 包括 形状 、 路 径 、 文 本 ， 图 像 等 ,用 于 将 Canvas 绘制 的 图 像 显 示 给 用 户 。 
* Pain: 相当 于 绘图 用 到 的 画笔 ， 可 以 设置 画笔 的 颜色 、 类 型 等 。 


若 在 自 定义 的 View 组 件 上 绘制 图 像 ， 只 需 重 写 onDraw0 方 法 即 可 。 示 例 代码 如 下 : 


public class MyView extends View { 
@override 
protected void onDraw (Canvas canvas) { 


// 使 用 Canvas 绘图 
) 
如 果 需 要 新 建 一 个 Canvas， 则 必须 定义 一 个 Bitmap 对 象 用 于 绘图 。 获 取 Bitmap WR, JP HL 
使 用 Canvas 绘图 的 示例 代码 如 下 : 


Bitmap b=Bitmap.createBitmap (100, 100, Bitmap.Config.ARGB_8888) ; 
Canvas c=new Canvas (b) ; 


// 使 用 Canvas 绘图 

若 使 用 SurfaceView 对 象 绘制 动态 图 像 ， 一 般 通 过 SurfaceHolderlockCanvas() 方 法 获取 Canvas 
对 象 ， 然 后 通过 Canvas 进行 绘图 ， 绘 图 结束 后 ， 通 过 surfaceHolder.unlockCanvasAndPost() 77 12: 1E Ji 
Canvas 对 象 。 示 例 代码 如 下 : 


SurfaceHolder surfaceHolder=surfaceView. getHolder(); 














Canvas canvas=surfaceHolder.lockCanvas(); // 获 得 canvas HR 
// 使 用 Canvas 绘图 
surfaceHolder.unlockCanvasAndPost (canvas) ; // 释 放 canvas 


10.1.2 ”使 用 自 定义 View 绘图 


实例 MyViewCanvasDemo 自 定义 一 个 名 为 MyView 的 
View 类 ， 并 在 其 onDraw0 方 法 中 绘制 简单 的 图 像 ， 运 行 效 
果 如 图 10.1 所 示 。 

实例 MyViewCanvasDemo 没有 使 用 布局 文件 ， 而 是 将 
自 定义 的 MyView 对 象 显 示 出 来 。 主 Activity 
MyViewCanvasDemoActivity 的 代码 如 下 : 







P MyViewCanvasDemo 


package introduction.android.MyViewCanvas; 


import android.app.Activity; 
import android.os.Bundle; 








! 

public class MyViewCanvasDemoActivity extends Activity i giew PER Canvaszyg, & 

( or B Ba 
/** Called when the activity is first created. */ A 
@override o 
public void onCreate (Bundle savedInstanceState) { 

super.onCreate (savedInstanceState) ; 图 10.1 简单 的 View 绘图 


setContentView (new MyView (this)) ; 
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} 
MyView 类 的 定义 代码 如 下 : 


package introduction.android.MyViewCanvas; 


import android.content.Context; 
import android.graphics.Canvas; 
import android.graphics.Color; 
import android.graphics.Paint; 
import android.view.View; 


public class MyView extends View ( 


public MyView (Context context) { 
super (context) ; 
// TODO Auto-generated constructor stub 
buildPoints(); 


private float[] mPts; 
private static final float SIZE-300; 
private static final int SEGS=32; 
private static final int X-0; 
private static final int Y-1; 
@Override 
protected void onDraw (Canvas canvas) { 
// TODO Auto-generated method stub 
super.onDraw (canvas) ; 
// 使 用 Canvas 绘图 
// 画 布 移动 到 (10,10) 位 置 
canvas.translate (10,10) ; 
// 画 布 使 用 白色 填充 
canvas.drawColor (Color.WHITE) ; 
// 创 建 红色 画笔 ， 使 用 单 像素 宽度 ， 绘 制 直线 
Paint paint=new Paint(); 
paint.setColor (Color.RED) ; 
paint.setStrokeWidth (0) ; 
canvas.drawLines (mPts, paint) ; 
// 创 建 蓝 色 画 笔 ， 宽 度 为 3， 绘 制 相关 点 
paint.setColor (Color.BLUE) ; 
paint.setStrokeWidth (3) ; 
canvas.drawPoints (mPts, paint) ; 
// 创 建 Path， 并 沿 着 path 显示 文字 信息 
RectF rect-new RectF (10,300,290,430) ; 
Path path-new Path(); 
path.addArc (rect, -180, 180) ; 
paint.setTextSize (18) ; 
paint.setColor (Color.BLUE) ; 
canvas.drawTextOnPath ("在 自 定义 View 中 使 用 Canvas 对 象 绘图 实例 ",path, 0, 0, paint) ; 


private void buildPoints() { 


// 生 成 一 系列 点 
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final int ptCount= (SEGS+1) * 2; 
mPts=new float[ptCount * 2]; 


float value=0; 

final float delta-SIZE / SEGS; 

for (int i-0; i«-SEGS; i++) { 
mPts[i*4+X]=SIZE - value; 
mPts[i*4-Y]-0; 
mPts [i*4+X+2]=07 
mPts[i*4+Y+2]=value; 
value+=delta; 


) 


所 有 具体 的 绘图 工作 都 由 Canvas 类 来 完成 。Canvas 类 提供 了 drawXXX() 方 法 来 完成 对 特定 形 
式 的 图 形 的 绘制 。 

在 Canvas 绘图 过 程 中 ， 涉 及 以 下 几 个 类 : 

(1) Color 

颜色 类 ， 其 中 以 静态 常量 的 方式 定义 常见 的 各 种 颜色 ， 例 如 黑色 ColorBLACK， 蓝 色 
Color.BLUE 等 ， 同 时 也 可 以 通过 以 下 方法 指定 颜色 的 具体 值 来 建立 颜色 对 象 。 

© static int argb ( int alpha, int red, int green, int blue ): 构造 一 个 包含 透明 要 素 的 颜色 对 象 。 

€ static int rgb ( int red, int green, int blue): 构造 一 个 由 RGB 三 色 组 成 的 颜色 对 象 。 


(2) Paint 
画笔 类 ， 通 过 该 类 的 对 象 创建 绘图 时 使 用 的 画笔 的 样式 。 使 用 Paint.setColor0 方 法 设置 画笔 的 
颜色 ， 使 用 setStrokeWidth0 方 法 设置 画笔 的 宽度 。 
(3) Path 
路 径 类 ,可 用 于 自 定义 各 种 路 径 。 本 实例 中 使 用 Path.addArc0 方 法 定义 了 一 个 弧 线 路 径 ， 并 沿 
着 该 路 径 显 示 了 说 明文 字 。 
Android 提供 各 种 各 样 的 用 于 绘制 图 形 的 方法 ， 在 此 不 可 能 一 一 介绍 ， 详 细 内 容 读者 可 以 参考 
Android SDK 文档 。 


10.1.3 使 用 Bitmap 绘图 


可 以 通过 新 建 Bitmap 对 象 并 在 其 上 使 用 Canvas 绘图 的 方式 创建 图 像 。 实 例 BitmapDrawDemo 
演示 了 Canvas 使 用 Bitmap 对 象 绘图 的 过 程 。 该 实例 绘制 的 内 容 与 10.1.2 节 实例 绘制 的 内 容 完全 相 
同 ， 只 不 过 不 是 直接 绘制 在 View 上 ， 而 是 绘制 在 一 个 Bitmap 对 象 上 ， 绘 制 完成 后 ， 将 Bitmap 图 
像 显 示 到 视图 上 ， 其 运行 效果 如 图 10.2 所 示 。 
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P BitmapDrawDemo 





l p 中 使 用 Canvas 对 象 给 各,、 
we Ex. 








图 10.2 Bitmap 对 象 的 绘图 效果 


该 视图 显示 的 是 一 幅 Bitmap 图 像 。 实 例 BitmapDrawDemo 的 主 Activity 为 BitmapDraw- 
DemoActivity， 其 代码 如 下 : 


package introduction.android.bitmapDrawDemo; 


import java.io.ByteArrayOutputStream; 
import android.app.Activity; 

import android.content.Context; 
import android.graphics.Bitmap; 
import android.graphics.BitmapFactory; 
import android.graphics.Canvas; 
import android.graphics.Color; 
import android.graphics.Paint; 
import android.graphics.Path; 

import android.graphics.RectF; 

import android.os.Bundle; 

import android.view.View; 


public class BitmapDrawDemoActivity extends Activity { 
private static final int WIDTH-320 ; 
private static final int HEIGHT-480 ; 
private static final int STRIDE-64; // must be»-WIDTH 


/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (new MyBitmapView (this)) ; 


private static Bitmap codec (Bitmap src, Bitmap.CompressFormat format,int quality) { 
ByteArrayOutputStream os-new ByteArrayOutputStream(); 
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src.compress (format, quality, os) ; 


byte[] array-os.toByteArray(); 
return BitmapFactory.decodeByteArray (array, 0, array.length) ; 


private class MyBitmapView extends View ( 
private Bitmap myBitmap; 
private float[] mPts; 
private static final float SIZE-300; 
private static final int SEGS-32; 
private static final int X-0; 
private static final int Y-1; 


@Override 

protected void onDraw (Canvas canvas) { 
// TODO Auto-generated method stub 
super.onDraw (canvas) ; 
canvas.drawBitmap (myBitmap, 0, 0,null) ; 


public MyBitmapView (Context context) { 
super (context) ; 
// TODO Auto-generated constructor stub 
buildPoints(); 
myBitmap-Bitmap.createBitmap (WIDTH,HEIGHT,Bitmap.Config.ARGB 8888) ; 
Canvas canvas-new Canvas (myBitmap) ; 
// 使 用 Canvas 绘图 
// 画 布 移动 到 (10,10) 位 置 
canvas.translate (10,10) ; 
// 画 布 使 用 白色 填充 
canvas.drawColor (Color.WHITE) ; 
// 创 建 红 色 画 笔 ， 使 用 单 像素 宽度 ， 绘 制 直线 
Paint paint=new Paint(); 
paint.setColor (Color.RED) ; 
paint.setStrokeWidth (0) ; 
canvas.drawLines (mPts, paint) ; 
// 创 建 蓝 色 画 笔 ， 宽 度 为 3， 绘 制 相关 点 
paint.setColor (Color.BLUE) ; 
paint.setStrokeWidth (3) ; 
canvas.drawPoints (mPts, paint) ; 
// 创 建 Path， 并 沿 着 path 显示 文字 信息 
RectF rect=new RectF (10,300,290,370) ; 
Path path-new Path(); 
path.addArc (rect, -180, 180); 
paint.setTextSize (18) ; 
paint.setColor (Color.BLUE) ; 
canvas.drawTextOnPath ("在 Bitmap 中 使 用 Canvas 对 象 绘图 实例 ",path, 0, 0, paint); 
myBitmap-codec (myBitmap, Bitmap.CompressFormat.JPEG, 80) ; 


private void buildPoints()( 
// 生 成 一 系列 点 
final int ptCount- (SEGS+1) * 2; 
mPts=new float[ptCount * 2]; 
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float value=0; 

final float delta=SIZE / SEGS; 

for (int i-0; i«-SEGS; i++) { 
mPts[i*44X]-SIZE - value; 
mPts[i*44Y]-0; 
mPts[i*4+X+2]=0; 
mPts[i*4+¥+2]=value; 
valuer-delta; 


) 


该 实例 新 建 了 一 个 名 为 MyBitmapView 的 View 2H fF, 在 该 组 件 的 构造 方法 中 创建 了 一 个 名 为 
myBitmap 的 Bitmap 对 象 ， 在 该 对 象 上 新 建 了 Canvas 对 象 并 绘制 了 图 人像。 绘制 完成 后 ， 通 过 
MyBitmapView 组 件 的 onDraw0 方 法 将 myBitmap 绘制 到 该 View 上 ， 最 后 通过 
BitmapDrawDemoActivity 将 MyBitmapView 显示 到 视图 上 。 


10.1.4 使 用 SurfaceView 绘制 静态 图 像 


使 用 SurfaceView 绘图 需要 为 SurfaceView 对 象 添加 SurfaceHoloder.Callback 接口 ， 并 在 该 接 
口 的 surfaceCreated0 方 法 中 通过 lockCanvas() 方 法 获取 Canvas 对 象 ， 以 此 保证 当 获取 Canvas 时 ， 
SurfaceView 对 象 可 用 。 当 绘图 工作 完成 后 ,通过 SurfaceHoloder. unlockCanvas- AndPost() 77 12:14 22: 
制 的 图 像 显示 出 来 ， 并 释放 Canvas 对 象 。 

实例 SurfaceViewDrawDemo 演示 了 使 用 SurfaceView 组 件 绘制 静态 图 像 的 过 程 ， 其 绘制 的 内 
容 与 10.1.2 节 绘 制 的 内 容 完全 相同 。 通 过 该 实例 ， 读 者 可 以 清楚 地 认识 到 使 用 SurfaceView 绘图 与 
使 用 View 绘图 的 不 同 之 处 ， 该 实例 运行 效果 如 图 10.3 所 示 。 


| | SurfaceViewDrawDemo 


FACanvas zy. 
Pi 5e. 
$ 

* 
* 





图 103 SurfaceView 绘图 效果 
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实例 Surface ViewDrawDemo 使 用 的 布局 文件 main.xml 内 容 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android: layout_width="fill parent" 


android: layout_height="fill parent" 






android: orientation="vertical"> 
<TextView 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android:text="@string/hello" /> 


<SurfaceView 
android: id="@+id/surfaceViewl" 
android: layout_width="fill parent" 
android: layout_height="fill parent" /> 


</LinearLayout> 


在 LinearLayout 布局 中 添加 了 一 个 SurfaceView 组 件 ， 通 过 该 组 件 进行 绘图 。 
实例 SurfaceViewDrawDemo 的 主 Activity 为 SurfaceDrawDemoActivity， 其 代码 如 下 : 


package introduction.android.surfaceViewDrawDemo; 


import android.app.Activity; 
import android.graphics.Canvas; 
import android.graphics.Color; 
import android.graphics. Paint; 
import android.graphics. Path; 
import android.graphics.RectF; 
import android.os.Bundle; 

import android.view.SurfaceHolder; 
import android.view.SurfaceView; 


public class SurfaceDrawDemoActivity extends Activity { 
private SurfaceView mySurfaceView; 
private float[] mPts; 
private static final float SIZE-300; 
private static final int SEGS-32; 
private static final int X-0; 
private static final int Y-1; 


/** Called when the activity is first created. */ 
@Override 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
buildPoints():; 
mySurfaceView- (SurfaceView) findViewById (R.id.surfaceViewl) ; 
SurfaceHolder surfaceHolder-mySurfaceView. getHolder(); 
surfaceHolder.addCallback (new SurfaceHolder.Callback() { 
@Override 
public void surfaceChanged (SurfaceHolder holder, int format, 
int width, int height) { 
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// TODO Auto-generated method stub 


@Override 
public void surfaceCreated (SurfaceHolder holder) { 
// 必须 在 该 方法 中 获取 Canvas 对 象 ， 才 能 保证 SurfaceView 可 用 
Canvas canvas=holder.lockCanvas () ;// 获 得 canvas 对 象 
// 使 用 Canvas 绘图 
// 画 布 移动 到 (10,10) 位 置 
canvas.translate (10,10) ; 
// 画 布 使 用 白色 填充 
canvas.drawColor (Color.WHITE) ; 
// 创 建 红色 画笔 ， 使 用 单 像素 宽度 ， 绘 制 直线 
Paint paint=new Paint(); 
paint.setColor (Color.RED) ; 
paint.setStrokeWidth (0) ; 
canvas.drawLines (mPts, paint) ; 
// 创 建 蓝 色 画笔 宽度 为 3， 绘 制 相 关 点 
paint.setColor (Color.BLUE) ; 
paint.setStrokeWidth (3) ; 
canvas.drawPoints (mPts, paint) ; 
// 创 建 Path， 并 沿 着 path 显示 文字 信息 
RectF rect-new RectF (10,250,290,480) ; 
Path path-new Path(); 
path.addArc (rect, -180, 180) ; 
paint.setTextSize (18) ; 
paint.setColor (Color.BLUE) ; 
canvas.drawTextOnPath ("在 SurfaceView 中 使 用 Canvas 对 象 绘制 静态 图 实例 ",path，0， 
0, paint) ; 
holder.unlockCanvasAndPost (canvas) ; //#iK canvas 对 象 并 显示 绘制 内 容 


@Override 
public void surfaceDestroyed (SurfaceHolder holder) { 
// TODO Auto-generated method stub 


We 


} 
private void buildPoints() { 
// 生 成 一 系列 点 
final int ptCount- (SEGS+1) * 2; 
mPts-new float[ptCount * 2]; 
float value-0; 
final float delta-SIZE / SEGS; 
for (int i-0; i«-SEGS; i++) { 
mPts[i*4+X]=SIZE - value; 
mPts[i*4-Y]-0; 
mPts [i*4+X+2]=0; 
mPts [i*4+¥+2]=value; 
value+=delta; 
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10.1.5 ”使 用 SurfaceView 绘制 动态 图 像 


实例 SurfaceViewDrawDemo 绘制 的 是 一 幅 静 态 图 像 ， 
而 使 用 SurfaceView 可 以 绘制 动态 图 像 。 绘制 动态 图 像 的 过 | SurfaceviewDynDrawDemo 
程 应 该 在 一 个 单独 的 线程 中 完成 ， 而 不 应 该 在 主线 程 中 进 在 SurfaceView 中 使 用 Canvas 对 象 绘制 
行 Sk f| SurfaceViewDynDrawDemo 演示 了 使 用 
SurfaceView 组 件 绘制 动态 图 像 的 过 程 。 该 实例 修改 自 
Android SDK 提供 的 实例 ， 绘 制 的 是 类 似 于 Windows 中 的 
变幻 线 屏保 的 效果 ， 运 行 效果 如 图 10.4 所 示 。 

实例 SurfaceViewDynDrawDemo 的 布局 文件 main.xml 
内 容 如 下 : 

<?xml version-"1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android. 
com/apk/res/android" 


android: layout_width="fill parent" 
android: layout_height="fill parent" 


EAE EE = z 
android:orientation="vertical"> 图 10.4 实例 Surface View: i 
<TextView 的 运行 效果 
android:layout width="fill parent" 


android:layout height-"wrap content" 
android:text="@string/hello" /> 








<SurfaceView 
android: id="@+tid/surfaceViewl" 
android: layout_width="fill parent" 
android: layout_height="fill parent" /> 


</LinearLayout> 


实例 SurfaceViewDynDrawDemo 的 主 Activity 为 SurfaceViewDynDrawDemoActivity, HV 
如 下 : 


package introduction.android.SurfaceViewDynDrawDemo; 


import introduction.android.SurfaceViewDynDrawDemo.SurfaceViewDynDrawDemoActivity.DrawingThread; 
import android.app.Activity; 

import android.graphics.Canvas; 

import android.graphics.Paint; 

import android.os.Bundle; 

import android.util.Log; 

import android.view.SurfaceHolder; 

import android.view.SurfaceView; 


public class SurfaceViewDynDrawDemoActivity extends Activity { 
private SurfaceView mySurfaceView; 
private DrawingThread mDrawingThread; 
SurfaceHolder surfaceHolder; 
/** Called when the activity is first created. */ 
@override 
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public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
mySurfaceView- (SurfaceView) findViewById (R.id.surfaceViewl) ; 
surfaceHolder-mySurfaceView. getHolder(); 
surfaceHolder.addCallback (new SurfaceHolder.Callback () { 


@Override 
public void surfaceChanged (SurfaceHolder holder, int format, 
int width, int height) { 
// TODO Auto-generated method stub 


@Override 
public void surfaceCreated (SurfaceHolder holder) { 
// TODO Auto-generated method stub 
mDrawingThread-new DrawingThread () ; 
mDrawingThread.mSurface=surfaceHolder; 
mDrawingThread. start (); 


@Override 

public void surfaceDestroyed (SurfaceHolder holder) { 
// TODO Auto-generated method stub 
mDrawingThread.mQuit=true; 


ps 


static final class MovingPoint { 
float x, y, dx, dy; 


void init (int width, int height, float minStep) { 
x= (float) ((width-1) *Math.random()) ; 
y= (float) ((height-1) *Math.random()) ; 
dx- (float) (Math.random()*minStep*2) 41; 
dy- (float) (Math.random()*minStep*2) +1; 


float adjDelta (float cur, float minStep, float maxStep) { 
cur4- (Math.random()*minStep) - (minStep/2) ; 
if (cur«0 && cur»-minStep) cur--minStep; 
if (cur»-0 && cur«minStep) cur=minStep; 
if (cur»maxStep) cur=maxStep; 
if (cur<-maxStep) cur--maxStep; 


return cur; 


void step (int width, int height, float minStep, float maxStep) 
xi-dx; 
if (x<=0 || x»- (width-1)) { 
if (x<=0) x-0; 
else if (x>= (width-1)) x-width-1; 
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dx=adjDelta (-dx, minStep, maxStep) 


f 

y+=dy; 

if (y<=0 || y>= (height-1)) { 
if (y<=0) y=0; 
else if (y>= (height-1)) y=height-1; 
dy-adjDelta (-dy, minStep, maxStep) ; 


class DrawingThread extends Thread { 
// These are protected by the Thread's lock 
SurfaceHolder mSurface; 
boolean mRunning; 
boolean mActive; 
boolean mQuit; 


// Internal state 
int mLineWidth; 
float mMinStep; 
float mMaxStep; 


boolean mInitialized-false; 
final MovingPoint mPointl-new MovingPoint(); 
final MovingPoint mPoint2-new MovingPoint(); 


static final int NUM OLD-100; 

int mNumOld-0; 

final float[] mOld-new float[NUM OLD*4]; 
final int[] mOldColor-new int[NUM OLD]; 
int mBrightLine-0; 


// X is red, Y is blue 
final MovingPoint mColor-new MovingPoint(); 


final Paint mBackground-new Paint(); 
final Paint mForeground-new Paint(); 





int makeGreen (int index) { 
int dist-Math.abs (mBrightLine-index) ; 
if (dist>10) return 0; 
return (255- (dist* (255/10))) ««8; 


@Override 
public void run() { 


mLineWidth- (int) (getResources() .getDisplayMetrics().density * 1.5) ; 


if (mLineWidth<1) mLineWidth=1; 
mMinStep=mLineWidth * 27 
mMaxStep=mMinStep * 3; 


mBackground. setColor (0xff000000) ; 
mForeground.setColor (0xff00ffff) ; 
mForeground.setAntiAlias (false) ; 
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mForeground.setStrokeWidth (mLineWidth) ; 


while (true) { 

if (qmQuit) { 

return; 

$ 

// Lock the canvas for drawing 

Canvas canvas-mSurface.lockCanvas(); 

if (canvas--null) { 
Log.i ("WindowSurface", "Failure locking canvas") ; 
continue; 


// Update graphics 
if (!mInitialized) { 
mInitialized-true; 
mPointl.init (canvas.getWidth(), canvas.getHeight(), mMinStep) ; 
mPoint2.init (canvas.getWidth(), canvas.getHeight(), mMinStep) ; 
mColor.init (127, 127, 1) ; 
} else { 
mPointl.step (canvas.getWidth(), canvas.getHeight(), 
mMinStep, mMaxStep) ; 
mPoint2.step (canvas.getWidth(), canvas.getHeight(), 
mMinStep, mMaxStep) ; 
mColor.step (127, 127, 1, 3) ; 
) 
mBrightLinet-2; 
if (mBrightLine» (NUM OLD*2)) ( 
mBrightLine--2; 


// Clear background 
canvas.drawColor (mBackground.getColor()) ; 


// Draw old lines 
for (int i-mNumOld-1; i»-0; i--) { 


mForeground.setColor (mOldColor[i] | makeGreen (i)) ; 
mForeground.setAlpha (((NUM OLD-i) * 255) / NUM OLD) ; 
int p-i*4; 


canvas.drawLine (mOld[p], mOld[p+1], mOld[p+2], mOld[p+3], mForeground) ; 


// Draw new line 

int red= (int) mColor.x+128; 

if (red>255) red=255; 

int blue= (int) mColor.y+128; 

if (blue>255) blue=255; 

int color=0xff£000000 | (red<<16) | blue; 
mForeground.setColor (color | makeGreen (-2)) ; 


canvas.drawLine (mPointl.x, mPointl.y, mPoint2.x, mPoint2.y, mForeground) ; 


// Add in the new line 

if (mNumOld»1) { 
System.arraycopy (mOld, 0, mOld, 4, (mNumOld-1) *4) ; 
System.arraycopy (mOldColor, 0, mOldColor, 1, mNumOld-1) ; 
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if (mNumOld«NUM OLD) mNumOld++; 
mOld[0]=mPoint1.x; 
mOld[1]-mPointl.y; 
mOld[2]-mPoint2.x; 
mOld[3]-mPoint2.y; 
mOldColor[0]-color; 


// All done 
mSurface.unlockCanvasAndPost (canvas) ; 


} 
) 


需要 注意 的 是 ， 就 像 前 面 所 提 到 的 ， 绘 制 动 态 图 像 的 过 程 必须 在 一 个 单独 的 线程 中 完成 ， 而 
不 能 在 主线 程 中 进行 。 在 该 实例 中 ， 绘 图 过 程 是 在 DrawingThread 中 完成 的 。 





10.2 Drawable 


Drawable 是 “可 绘制 的 东西 ”的 抽象 类 ， 被 定义 在 android.graphics.drawable 包 下 。 该 类 继承 
了 很 多 代表 不 同形 状 的 子 类 ， 例 如 BitmapDrawable、ShapeDrawable、PictureDrawable 等 。 开 发 者 
也 可 以 定义 自己 的 用 于 特定 形状 绘制 的 子 类 。 

获取 Drawable 对 象 有 三 种 方式 : 

© ”使 用 工程 资源 文件 中 保存 的 图 像 资源 。 

e 使 用 XML 文件 定义 的 Drawable 属性 。 

o ”通过 构造 方法 构建 。 


10.2.1 从 资源 文件 中 创建 Drawable 对 象 


添加 图 像 到 应 用 程序 工程 中 最 简单 的 方式 是 从 资源 文件 中 获取 图 像 。 资 源 文件 中 的 图 像 资 源 
会 被 放置 在 res/drawable/ 文 件 夹 下 ， 常 见 的 图 像 资 源 类 型 有 PNG. JPG 和 GIF， 在 允许 的 情况 下 ， 
建议 优先 使 用 PNG 格式 的 图 像 ， 其 次 是 卫 G 格式 的 图 像 。 系 统 会 自动 为 每 个 drawable 文件 夹 下 的 
资源 文件 生成 一 个 格式 为 R.drawable.xxx 的 ID 号 , 在 工程 中 可 以 通过 该 ID 使 用 该 资源 。 在 之 前 的 
实例 中 ， 我 们 一 直 在 使 用 这 种 方法 。 

例如 ， 在 res/drawable/ 文 件 夹 下 有 一 个 资源 文件 为 my_image.png， 系 统 为 其 生成 的 资源 ID 为 
R.drawable.my_image， 在 ImageView 组 件 中 使 用 该 图 像 的 代码 如 下 : 


ImageView i=new ImageView (this) ; 
i.setImageResource (R.drawable.my image) ; 


如 果 要 获得 该 资源 的 Drawable 对 象 ， 可 使 用 如 下 代码 : 


Resources res-mContext.getResources(); 
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Drawable myImage=res.getDrawable (R.drawable.my image) ; 


10.22 M XML 文件 中 创建 Drawable 对 象 


以 TransitionDrawable 对 象 为 例 ， 假 设 XML 文件 中 的 描述 如 下 : 


<transition xmlns:android-"http://schemas.android.com/apk/res/android"» 
<item android:drawable="@drawable/image expand"> 
<item android:drawable="@drawable/image collapse"> 

</transition> 


从 该 XML 文件 中 获取 TransitionDrawable 对 象 的 代码 如 下 : 


Resources res=mContext .getResources () 7 

TransitionDrawable transition= (TransitionDrawable) 
res.getDrawable (R.drawable.expand_collapse) ; 

ImageView image- (ImageView) findViewById (R.id.toggle image) ; 
image.setImageDrawable (transition) ; 


获取 到 TransitionDrawable 对 象 后 ， 便 可 以 操作 该 对 象 ， 例 如 : 


transition.startTransition (1000) ; 


10.2.3 ”使 用 构造 方法 创建 Drawable 对 象 


以 ShapeDrawable 为 例 ，ShapeDrawable 是 Drawable 的 子 类 ，ShapeDrawable 对 象 适合 动态 绘 
制 二 维 图 形 。 以 下 代码 演示 了 使 用 ShapeDrawable 对 象 在 自 定 义 View 组 件 上 绘制 一 个 椭圆 的 过 程 : 


public class CustomDrawableView extends View { 
private ShapeDrawable mDrawable; 


public CustomDrawableView (Context context) { 
super (context) ; 


int x-10; 
int y-10; 
int width-300; 
int height-50; 


mDrawable-new ShapeDrawable (new OvalShape()) ; 

mDrawable.getPaint().setColor (0xff74AC23) ; 

mDrawable.setBounds (x, y, xtwidth, y+height) ; 
} 


protected void onDraw (Canvas canvas) { 
mDrawable.draw (canvas) ; 


) 
绘制 完成 后 ， 可 通过 以 下 代码 将 自 定义 的 View 组 件 设置 为 Activity 的 视图 : 


CustomDrawableView mCustomDrawableView; 
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protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
mCustomDrawableView=new CustomDrawableView (this) ; 


setContentView (mCustomDrawableView) ; 
ii 


自 定义 的 View 组 件 也 可 以 通过 以 下 代码 被 放置 到 XML 文件 中 使 用 : 


<introducton.android.shapedrawable.CustomDrawableView 
android: layout_width="fill parent" 
android: layout_height="wrap_ content" 

/> 


10.3 3D 绘图 


10.3.1 OpenGL ES 简介 


OpenGL 是 一 组 跨 平台 的 3D 图 像 处 理 API, OpenGL ES 是 OpenGL 的 嵌入 式 版 本 ，Android 
系统 从 Android 1.0 开始 支持 OpenGL ES 1.0 和 1.1， 自 Android 2.2 (API Level 8) 开始 ，Android 
框架 开始 支持 OpenGL 2.0 API。 

由 于 篇 幅 所 限 ， 在 此 不 可 能 详细 地 介绍 OpenGL ES 的 方方面面 ， 仅 能 简单 介绍 其 使 用 方法 。 
详细 资料 读者 可 以 查询 Android SDK 的 相关 文档 。 


10.3.2 绘制 3D 图 像 实例 


使 用 OpenGL ES API 绘制 3D 图 像 有 两 个 基础 的 相关 类 ， 一 个 是 GLSurfaceView 类 ， 另 一 个 

是 GLSurfaceView.Renderer 接口 。 
(1) GLSurfaceView 类 

GLSurfaceView 类 是 SurfaceView MFA, (EH AKI Surface 进行 OpenGL 绘图 泻 染 。 
GLSurfaceView 提供 以 下 功能 : 
管理 Surface, Surface 是 一 块 内 存 ， 可 以 被 加 载 到 View MAY. 
管理 一 个 EGL 显示 ， 能 够 使 用 OpenGL 把 内 容 泻 染 到 Surface 上 。 
接受 用 户 自 定义 泻 染 器 用 于 实际 泻 染 。 
使 泻 染 器 在 单独 的 线程 中 运行 ， 与 更 新 UI 的 线程 相 分 离 。 
AFB E IRE (on-demand rendering) 和 连续 泻 染 ( continuous rendering ). 
提供 一 些 可 选 工具 ， 如 OpenGL 调用 的 跟踪 调试 和 错误 检查 等 。 





(2) GLSurfaceView.Renderer 接口 
GLSurfaceView.Renderer 接口 定义 了 使 用 OpenGL 绘图 时 所 需 的 方法 。 该 接口 通过 
GLSurfaceView.setRenderer() Ej GLSurfaceView 关联 在 一 起 。 
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该 接口 实现 以 下 三 个 方法 。 

© onSurfaceCreated(): 当 创 建 GLSurfaceView 对 象 后 ， 该 方法 被 系统 调用 一 次 。 通 常 在 该 方法 
中 设置 OpenGL 环境 的 相关 参数 ， 初 始 化 OpenGL 图 形 对 象 等 。 

* onDrawFrame(): GLSurfaceView 对 象 每 一 次 重 绘 时 系统 都 会 调用 该 方法 。 该 方法 应 该 执行 具 
体 的 绘图 工作 。 

* onSurfaceChanged(): 3i GLSurfaceView 对 象 的 几何 外 形 改 变 时 ， 包 括 GLSurfaceView 的 尺寸 
发 生 改 变 、 设 备 屏幕 的 方向 发 生 改 变 等 情况 ， 该 方法 被 系统 调用 。 

实例 OpenGLDemo 演示 了 在 Activity 中 使 用 GLSurfaceView 和 GLSurfaceView.Renderer 合作 

绘制 三 维 图 形 的 过 程 。 该 实例 绘制 了 一 个 不 断 旋转 的 立方 体 ， 运 行 效果 如 图 10.5 所 示 。 


| opencLpemo 





图 10.5 实例 OpenGLDemo 的 运行 效果 
该 立方 体 为 MyCube 类 的 对 象 。MyCube.java 的 代码 如 下 : 


package introduction.android.openglDemo; 


import java.nio.ByteBuffer; 

import java.nio.ByteOrder; 

import java.nio.IntBuffer; 

import javax.microedition.khronos.opengles.GL10; 
class MyCube 

{ 

private IntBuffer vertexBuffer; 

private IntBuffer colorBuffer; 

private ByteBuffer indexBuffer; 


public MyCube () 
{ 
int one=65536; 
int vertex []={ 
-one, -one, -one, 


one, -one, -one, 
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该 立方 体 被 显示 在 GLSurfaceView 对 象 中 ， 由 GLSurfaceView.Renderer 接口 绘制 。 
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GLSurfaceView 在 主 Activity 的 onCreate0 方 法 中 被 创建 ， 相 关 代码 如 下 : 


package introduction.android.openglDemo; 
import android.app.Activity; 
import android.opengl.GLSurfaceView; 
import android.os.Bundle; 
public class OpenGLDemoActivity extends Activity ( 
private GLSurfaceView myGLSurfaceView; 
/** Called when the activity is first created. */ 
@Override 
protected void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
myGLSurfaceView=new GLSurfaceView (this) ; 
myGLSurfaceView.setRenderer (new CubeRenderer()) ; 
setContentView (myGLSurfaceView) ; 
) 
@Override 
protected void onResume() { 
super.onResume(); 
myGLSurfaceView.onResume(); 
) 
@Override 
protected void onPause() { 
super. onPause () 7 
myGLSurfaceView.onPause(); 


} 

其 中 : 

myGLSurfaceView.setRenderer (new CubeRenderer()) ; 
指定 了 GLSurfaceView 的 泻 染 器 为 CubeRenderer, Hix edd Ez 
在 CubeRendererjava 中 ， 有 具体 代码 如 下 : 


package introduction.android.openglDemo; 
import android.opengl.GLSurfaceView; 
import javax.microedition.khronos.egl.EGLConfig; 





过 程 。 泻 染 器 被 定义 


import javax.microedition.khronos.opengles.GL10; 
class CubeRenderer implements GLSurfaceView.Renderer { 
private MyCube myCube; 
private float roate; 
public CubeRenderer () { 
myCube-new MyCube () ; 
} 
public void onDrawFrame (GL10 gl) { 
// 填 充 屏幕 
gl.glClear (GL10.GL COLOR BUFFER BIT | GL10.GL DEPTH BUFFER BIT) ; 
// 设 置 模型 视 景 矩阵 为 当前 操作 矩阵 
gl.glMatrixMode (GL10.GL MODELVIEW) ; 
// 将 坐标 原点 移动 到 屏幕 中 心 
gl.glLoadIdentity(); 
// 移 动 坐标 系 
gl.glTranslatef (0, 0, -3.0£) ; 
// 在 Y 轴 方向 旋转 坐标 系 
gl.glRotatef (roate, Oe OE 
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// 在 X 轴 方向 旋转 坐标 系 
gl.glRotatef (roate*0.25f, 1, 0, 0); 
// 开 启 顶 点 坐标 
gl.glEnableClientState (GL10.GL VERTEX ARRAY) ; 
// 开 启 颜色 
gl.glEnableClientState (GL10.GL COLOR ARRAY) ; 
// 绘 制图 形 
myCube.draw (gl) ; 
roatet-1l.0f; 

) 

public void onSurfaceChanged (GL10 gl, int width, int height) { 
gl.glViewport (0, 0, width, height) ; 
float ratio- (float) width / height; 
gl.glMatrixMode (GL10.GL PROJECTION) ; 
gl.glLoadIdentity|(); 
gl.glFrustumf (-ratio, ratio, -1, 1, 1, 10) ; 

T 

public void onSurfaceCreated (GL10 gl, EGLConfig config) ( 
gl.glEnable (GL10.GL CULL FACE) ; 
gl.glClearColor (0.5F,0.5F,0.5F,1.0F) ; 


10.4 硬件 加 速 


从 Android 3.0 (API Level 11) 开始 ，Android 2D 泻 染 管线 被 设计 为 能 更 好 地 支持 硬件 加 速 功 
能 。 硬 件 加 速 功能 将 所 有 在 View 组 件 的 Canvas 上 执行 的 绘制 操作 都 交 由 GPU 来 完成 。 由 于 硬件 
加 速 功能 需要 更 多 的 资源 ， 因 此 启用 硬件 加 速 功能 的 应 用 程序 会 耗费 更 多 的 内 存 资源 。 


10.4.1 启用 硬件 加 速 


启用 硬件 加 速 最 简单 的 方法 是 在 总 体 上 为 整个 应 用 程序 打开 硬件 加 速 功能 。 如 果 应 用 程序 中 
仅仅 使 用 了 标准 的 View 和 Drawable 对 象 进行 图 像 绘制 ， 那 么 在 总 体 上 打开 硬件 加 速 功能 不 会 出 
现任 何不 良 影响 。 但 是 ， 由 于 硬件 加 速 功 能 并 不 是 被 所 有 的 2D 绘制 操作 所 支持 的 ， 因 此 对 于 一 些 
自 定义 的 View 组 件 和 Drawable 对 象 的 绘制 ， 可 能 会 出 现 无 法 显示 、 异 常 或 者 错误 泻 染 的 点 等 问 
题 。 为 了 避免 这 类 问题 的 发 生 ，Android 平台 提供 了 以 下 4 个 应 用 层次 的 硬件 加 速 开关 设置 。 
Application， 应 用 程序 级 。 

Activity， 视 图 级 。 
Window， 窗 口 级 。 
View， 组 件 级 。 


HTE Application 等 级 打开 硬件 加 速 功能 , 则 整个 应 用 程序 中 所 有 的 绘图 工作 都 使 用 硬件 加 速 。 
打开 方法 是 在 应 用 程序 的 配置 文件 AndroidManifest.xml 的 <application> 中 添加 如 下 代码 : 
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<application android:hardwareAccelerated-"true" ...> 


若 在 整个 应 用 程序 等 级 下 使 用 硬件 加 速 功 能 导致 了 某 些 问题 , 则 可 以 针对 某 个 Activity 具体 设 
置 是 否 打开 硬件 加 速 功能 。 以 下 代码 表示 在 应 用 程序 等 级 启用 硬件 加 速 功 能 ， 但 是 对 某 个 Activity 
不 使 用 硬件 加 速 功 能 : 


<application android:hardwareAccelerated="true"> 
<activity ... /> 
<activity android:hardwareAccelerated="false" /> 
</application> 


如 果 需 要 更 细 粒 度 的 控制 ， 可 以 通过 以 下 代码 使 某 个 窗口 获得 硬件 加 速 功 能 。 


getWindow().setFlags C 
WindowManager.LayoutParams.FLAG HARDWARE ACCELERATED, 
WindowManager.LayoutParams. FLAG HARDWARE ACCELERATED) E 


就 目前 的 API 控制 来 讲 ， 仅 支持 打开 某 个 窗口 的 硬件 加 速 功能 ， 而 不 支持 关闭 某 个 窗口 的 硬 
件 加 速 功能 。 

在 View 等 级 ， 可 以 在 运行 时 关闭 某 个 View 组 件 的 硬件 加 速 功能 ， 但 是 在 这 个 等 级 ， 只 能 关 
闭 硬件 加 速 功能 ， 不 能 启用 硬件 加 速 功能 。 

在 某 些 情况 下 , 能 够 知道 当前 应 用 程序 或 者 某 个 自 定义 View 是 否 被 正确 地 硬件 加 速 是 很 有 用 
的 ， 尤 其 是 当 不 是 所 有 的 自 定义 绘图 操作 都 被 泻 染 管线 很 好 地 支持 的 时 候 。 

有 两 种 方式 可 以 确认 当前 应 用 程序 是 否 被 硬件 加 速 。 

© ViewisHardwareAccelerated(): 当 View 被 附加 到 硬件 加 速 的 窗口 时 ， 返 回 true. 

e CanvasisHardwareAccelerated(): 当 Canvas 被 硬件 加 速 时 ， 返 回 true. 


如 果 必 须要 做 这 样 的 检查 ， 尽 量 使 用 Canvas.isHardwareAccelerated0 方 法 代替 View. 
isHardwareAccelerated() 方 法 。 因 为 当 View 被 附加 到 硬件 加 速 的 窗口 时 ， 它 仍 有 可 能 使 用 非 硬件 加 
速 的 Canvas 进行 绘制 。 这 种 情况 在 因为 缓存 原因 将 View 绘制 到 位 图 中 时 经 常 发 生 。 


10.4. Android 绘图 模型 


1. 基于 软件 的 绘图 模型 

当 应 用 程序 需要 更 新 UI 的 某 一 个 部 分 时 ， 会 通过 更 改 内容 的 View 组 件 调用 invalidate() 方 法 
将 当前 组 件 无 效 化 。 该 方法 触发 一 个 重 绘 消 息 ， 该 消息 会 沿 着 视图 的 层次 一 直 向 上 传递 ， 以 计算 需 
要 重 绘 的 区 域 。 然 后 Android 系统 会 重 绘 在 视图 层次 中 与 要 重 绘 区域 有 交叉 的 所 有 组 件 。 

基于 软件 的 绘图 模式 主要 完成 如 下 两 个 工作 : 

© ”无效 化 绘图 层次 。 

e 重 绘 绘图 层次 。 

这 种 绘图 模型 有 以 下 两 个 缺点 。 


第 一 个 缺点 是 ， 这 个 模型 会 导致 在 消息 传递 过 程 中 多 执行 大 量 无 效 的 绘图 代码 。 例 如 ， 一 个 
按钮 位 于 一 个 View 上 ， 当 该 按钮 被 单 击 时 ， 虽 然 该 View 没有 发 生 任 何 改变 ， 但 是 在 这 种 绘图 模 
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型 下 ， 该 View 也 会 被 重 绘 。 

第 二 个 缺点 是 ， 这 种 绘图 模型 可 能 隐藏 应 用 程序 中 的 Bug. 由 于 Android 系统 会 重 绘 所 有 与 需 
重 绘 区域 有 交叉 的 View 组 件 ， 一 个 被 用 户 改 变 了 内 容 的 View 组 件 可 能 会 被 重 绘 ， 即 使 该 组 件 没 
有 调用 invalidate() 方 法 。 当 这 种 情况 发 生 的 时 候 , 用 户 只 能 依靠 另 一 个 组 件 的 重 绘 操作 来 获取 自己 
想 要 的 效果 , 而 这 种 效果 可 能 会 不 断 改变 。 因 此 , 开发 者 应 该 在 自 定义 的 组 件 上 不 断 调 用 invalidate) 
方法 以 保证 内 容 显 示 正 确 ， 无 论 该 组 件 的 内 容 是 否 被 改变 。 

当 Android 组 件 的 内 容 发 生 改变 , 如 背景 色 改变 或 者 文本 改变 时 ,该 组 件 会 自动 调用 invalidate) 
方法 。 

2. 硬件 加 速 绘制 模型 


在 硬件 加 速 绘 制 模型 下 ，Android 系统 依然 使 用 invalidate0 方 法 和 draw0 方 法 来 对 屏幕 进行 更 
新 并 绘制 图 形 ， 但 是 具体 处 理 的 方法 有 所 不 同 。 这 种 模式 下 ，Android 系统 并 没有 马上 执行 绘图 命 
令 ， 而 是 记录 了 当前 视图 的 显示 列表 。 显 示 列表 中 包含 视图 层次 中 所 有 绘图 代码 的 输出 。Android 
系统 只 需要 录制 并 且 更 新 需要 重 绘 组 件 的 显示 列表 即 可 。 那 些 没有 被 无 效 化 的 组 件 可 以 简单 通过 重 
新 使 用 之 前 记录 的 显示 列表 的 方式 来 重 绘图 形 。 

硬件 加 速 绘图 模型 主要 完成 如 下 三 个 工作 : 


© 无效 化 视图 的 绘图 层次 。 
e ”记录 并 更 新 显示 列表 。 
e 绘制 显示 列表 。 


在 这 种 模式 下 , 通过 需要 更 新 的 组 件 的 draw0 方 法 来 更 新 图 像 ， 而 是 应 该 调用 invalidate() 方 法 
来 使 Android 系统 记录 组 件 的 显示 列表 。 如 果 没 有 这 样 做 ， 该 组 件 的 更 新 将 不 会 显示 出 来 。 

使 用 显示 列表 方式 绘制 图 像 对 动画 绘制 也 有 很 大 好 处 。 因 为 设置 特定 属性 ， 例 如 透明 度 、 旋 
转 灯 ,不 需要 重新 绘制 整个 视图 , 而 只 需 对 特定 属性 进行 更 改 即 可 。 例 如 ,假如 有 一 个 LinearLayout, 
该 LinearLayout 中 包含 一 个 ListView 组 件 和 一 个 Button 组 件 ，ListView 组 件 被 放置 在 Button 组 件 
的 上 面 。 该 LinearLayout 组 件 的 显示 列表 如 下 : 

® DrawDisplayList ( ListeView ) 

* DrawDisplayList ( Button ) 


如 果 开发 者 需要 更 改 ListView 的 透明 度 , 那么 通过 ListView 对 象 调用 setAlpha (0.5f) 方法 后 ， 
LinearLayout 的 显示 列表 如 下 : 
SaveLayerAlpha ( 0.5 ) 
DrawDisplayList ( ListeView ) 
Restore 
DrawDisplayList ( Button ) 


由 此 可 见 ， 绘 图 ListView 的 复杂 代码 并 没有 被 执行 ， 系 统 只 是 简单 更 新 了 LinearLayout ff] Sj 
示 列 表 。 对 于 一 个 没有 被 硬件 加 速 的 应 用 程序 ， 该 过 程 中 的 每 一 行 代码 都 会 被 重新 执行 一 次 。 
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10.5 RenderScript 


RenderScript 基于 C99 标准 提供 了 一 个 平台 独立 的 运行 在 底层 的 计算 引擎 , 用 于 加 速 需要 大 量 
计算 的 应 用 程序 ， 常 用 于 3D 图 像 泻 染 。 
RenderScript 的 主要 优点 如 下 。 


可 移植 性 : RenderScript 被 设计 为 在 各 种 具有 不 同 CPU 和 CPU 架构 的 设备 上 运行 . 由 于 其 代 
码 是 在 运行 设备 上 进行 编译 和 缓存 的 ， 因 此 RenderScript 可 以 支持 所 有 架构 而 不 需要 针对 某 
种 架构 具体 编程 。 

性 能 : RenderScript 能 够 提供 与 OpenGL 相似 的 性 能 , 同时 提供 与 Android 框架 提供 的 OpenGL 
API ( android.opengl ) 相同 的 移植 性 。 另 外 ，RenderScript 提供 OpenGL 所 没有 的 高 性 能 计算 
API, 

可 用 性 : RenderScript 尽 可 能 简化 了 开发 过 程 。 


当然 ，RenderScript 也 有 缺点 ， 主 要 表现 在 以 下 方面 。 


开发 复杂 : RenderScript 提供 资金 的 API 集合 ， 开 发 者 需要 重新 学 习 。RenderScript 处 理 内 存 
的 方式 与 OpenGL 不 同 。 

调试 可 见 : RenderScript 可 以 在 其 他 处 理 器 上 被 执行 ， 而 不 是 主 CPU 上 。 在 这 种 情况 下 ， 调 
试 变 得 很 困难 。 

特性 较 少 : RenderScript 不 像 OpenGL 那样 提供 很 多 特性 ， 例 如 压缩 纹理 格式 或 者 GL 扩展 。 


10.5.1 RenderScript 综述 


RenderScript 采用 的 是 主 从 结构 。 底 层 的 本 地 化 代码 被 高 层 的 运行 的 虚拟 机 中 的 Android 系统 


控制 。 


Android 虚拟 机 保有 内 存 和 声明 周期 的 控制 权 , 在 需要 的 时 候 调 用 本 地 的 RenderScript 代码 。 


本 地 化 代码 被 编译 为 中 间 的 字 节 码 , 并 且 被 打包 到 应 用 程序 的 .apk 文件 中 。 当 应 用 程序 在 设备 上 运 
行 的 时 候 ， 字 节 码 被 编译 为 针对 当前 机 器 优化 的 机 器 码 。 编 译 的 字 节 码 被 缓存 起 来 ， 因 此 之 后 需要 
使 用 RenderScript 代码 时 不 需要 重新 编译 。RenderScript 有 三 个 层次 的 代码 ， 人 允许 本 地 化 代码 和 
Android 框架 之 间 进 行 通信 。 


本 地 RenderScript 层 : 该 层 负责 密集 运算 或 者 图 像 泻 染 ， 相 关 代 码 被 保存 在 Ts RA sh 文件 
Pe 
反射 层 : 该 层 由 一 系列 类 组 成 ， 这 些 类 由 本 地 代码 反射 而 来 。 基 本 上 是 对 本 地 代码 的 包装 ， 
以 允许 Android 框架 与 本 地 RenderScript 代码 进行 交互 。Android Build 工具 自动 生成 该 层 的 
相关 类 。 

Android 框架 层 : 该 层 由 Android 框架 API 组成， 包括 android.renderscript 包 。 该 层 用 于 给 反 
射 层 发 出 高 级 命令 , 如 “旋转 视图 ” 或 者 “过 滤 位 图 ”， 然后 反射 层 将 命令 传送 给 本 地 层 执 行 。 


(1) 本 地 RenderScript 层 的 关键 特性 包括 : 
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e ”大量 针对 标量 和 向 量 计算 的 数学 函数 ， 包 含 加 、 乘 、 加 乘 、 点 乘 等 。 

日 ”原始 数据 与 向 量 的 转换 例 程 ， 如 敌阵 例 程 、 日 期 和 时 间 例 程 、 图 像 例 程 等 。 
e HB. 

e EUER, 

e 内存 分 配 请 求 特性 。 

e 


支持 RenderScript 系统 的 数据 类 型 和 结构 ， 例 如 二 维 向 量 、 三 维 向 量 、 四 维 向 量 等 。 


RenderScript 库 相 关头 文件 被 放置 在 <Androidsdk root»/platform-tools/renderscriptinclude 目录 
下 。 该 目录 下 的 头 文件 会 被 自动 保存 进 .rs 文件 中 ， 除 了 RenderScript 的 图 像 处 理 头 文件 。 因 此 ， 需 
要 使 用 下 面 的 代码 手工 导入 : 


#include "rs graphics.rsh" 

(2) 反射 层 是 一 组 由 Android Build 工具 生成 的 类 ， 可 以 从 Android 虚拟 机 访问 本 地 的 
RenderScript 代码 。 反 射 层 定义 了 RenderScript 函数 和 变量 的 访问 点 ， 也 提供 了 构造 方法 ， 用 于 为 
定义 在 RenderScript 代码 中 的 指针 分 配 内 存 。 

下 面 简单 介绍 被 反射 的 主要 组 件 。 
每 个 .rs 文件 都 生成 一 个 类 , 被 存放 在 名 为 ScriptC_renderscript filename 的 ScriptC 类 型 的 文件 
中 ， 它 相当 于 .rs 文件 的 java 版 本 ， 可 以 被 Android 框架 调用 。 该 类 包含 下 列 反射 : 
e JS 文件 中 的 非 静态 方法 。 
o 非 静 态 的 全 局 的 RenderScript 变量 。 
e El. 
(3) Android 框架 层 通常 由 Android 框架 API 组 成 ， 包 含 android.renderscript 包 。 该 层 管理 


Activity 的 声明 周期 以 及 应 用 程序 的 内 存 分 配 。 它 通过 反射 层 发 送 命令 给 本 地 RenderScript 代码 ， 
并 接收 用 户 事件 ， 按 需 传递 给 RenderScript 代码 。 


10.5.2 ”使 用 动态 分 配 的 内 存 


涉及 RenderScript 内 存 分 配 API 的 类 有 三 个 ， 分 别 说 明 如 下 。 

* Element 内 存 分 配 的 基本 单位 ， 可 以 是 基本 的 数据 类 型 或 者 复合 类 型 。 

© Typ: 表示 要 分 配 的 元 素 个 数 。 

* Allocation: 用 于 执行 分 配 内 存 操作 。 

RenderScript 支持 指针 ， 但 是 必须 在 Android 框架 代码 中 为 它 分 配 内 存 。 当 开发 者 在 :rs 文件 中 
声明 一 个 全 局 的 指针 时 ， 需 要 通过 合适 的 反射 层 类 来 分 配 内 存 ， 并 将 其 绑 定 到 本 地 的 RenderScript 
层 。 开 发 者 可 以 通过 Android 框架 层 和 RenderScript 层 读 写 该 内 存 。 

1. 定义 指针 

由 于 RenderScript 是 使 用 C99 开发 的 ， 声 明 指 针 的 方式 也 和 C99 语法 很 相似 。 以 下 代码 声明 
了 一 个 Struct 结构 ， 并 为 其 定义 了 指针 ， 另 外 还 定义 了 一 个 指向 int32 t 类 型 的 指针 。 
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#pragma version (1) 
#pragma rs java_package_name (com.example.renderscript) 


typedef struct Point { 
float2 point; 
) Point t; 


Point t *touchPoints; 
int32 t *intPointer; 


这 些 代码 需要 被 定义 在 .rs 文件 中 。 

2. 反射 指针 

全 局 变量 会 有 对 应 的 get 和 set 方法 生成 。 一 个 全 局 指针 会 生成 一 个 bind_pointerName() 方 法 以 
代替 set 方法 。 该 方法 允许 将 Android 虚拟 机 分 配 的 内 存 绑 定 到 本 地 的 RenderScript。 以 下 代码 是 为 
前 面 代码 定义 的 两 个 指针 生成 存 取 方 法 的 代码 : 


private ScriptField Point mExportVar_touchPoints; 
public void bind_touchPoints (ScriptField Point v) { 
mExportVar touchPoints-v; 
if (v--null) bindAllocation (null, mExportVarIdx touchPoints) ; 
else bindAllocation (v.getAllocation(), mExportVarIdx touchPoints) ; 





public ScriptField Point get touchPoints()( 
return mExportVar touchPoints; 


private Allocation mExportVar intPointer; 

public void bind intPointer (Allocation v) { 
mExportVar intPointer-v; 
if (v--null) bindAllocation (null, mExportVarIdx intPointer) ; 
else bindAllocation (v, mExportVarIdx_intPointer) ; 


public Allocation get_intPointer() { 
return mExportVar intPointer; 


) 
这 些 代码 应 该 被 定义 在 ScriptC rs filename 文件 中 。 
3. 分 配 并 绑 定 内 存 到 RenderScript 
当 Build 工具 生成 反射 层 类 后 ， 就 可 以 使 用 合适 的 反射 层 为 指针 分 配 内 存 。 以 下 代码 演示 了 为 
intPointer 和 touchPoints 两 个 指针 分 配 内 存 并 绑 定 到 RenderScript 的 方法 : 


private RenderScriptGL glRenderer; 
private ScriptC_example script; 
private Resources resources; 
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public void init (RenderScriptGL rs, Resources res) { 
//get the rendering context and resources from the calling method 
glRenderer=rs; 


resources=res; 


//allocate memory for the struct pointer, calling the constructor 
ScriptField Point touchPoints=new ScriptField Point (glRenderer, 2) ; 


//Create an element manually and allocate memory for the int pointer 
intPointer-Allocation.createSized (glRenderer, Element.I32 (glRenderer) , 2) ; 


//create an instance of the RenderScript, pointing it to the bytecode resource 
mScript-new ScriptC example (glRenderer, resources, R.raw.example) ; 


// bind the struct and int pointers to the RenderScript 
mScript.bind touchPoints (touchPoints) ; 
script.bind intPointer (intPointer) ; 


//bind the RenderScript to the rendering context 
glRenderer.bindRootScript (script) ; 


} 

4. 读 写 内 存 

虽然 内 存 是 由 Android 虚拟 机 分 配 的 ， 但 是 在 本 地 的 RenderScript 代码 和 Android 代码 中 都 可 
以 对 内 存 进行 读 写 。 一 旦 内 存 被 绑 定 ， 本 地 RenderScript 代码 就 可 以 直接 访问 内 存 ， 反 射 层 类 也 可 
以 通过 读 写 方法 访问 内 存 。 若 在 Android 框架 层 中 修改 了 内 存 内 容 , 则 会 自动 同步 到 本 地 层 。 若 在 .rs 
文件 中 修改 了 内 存 内 容 ， 则 这 些 改变 不 会 传递 回 Android 框架 层 。 以 下 代码 演示 了 在 Android 代码 
中 修改 Struct 的 方法 : 


int index=0; 

boolean copyNow=true; 

Float2 point-new Float2 (0.0f, 0.0f) ; 
touchPoints.set point (index, point, copyNow) ; 


在 本 地 RenderScript 代码 中 读 取 该 内 存 的 代码 如 下 : 


rsDebug ("Printing out a Point", touchPoints[0].point.x, touchPoints[0].point.y) ; 


10.5.3 ”使 用 静态 分 配 的 内 存 


在 RenderScript 中 声明 的 非 静态 全 局 原始 数据 类 型 和 结构 体 很 容易 使 用 , 因为 这 些 内 存 是 静态 
分 配 的 。Android Build 工具 在 生成 反射 层 类 时 会 自动 为 这 些 变量 生成 存 取 方 法 ， 开 发 者 可 以 通过 
这 些 方法 来 使 用 静态 分 配 的 内 存 。 

例如 ， 在 RenderScript 代码 中 声明 如 下 变量 : 


uint32_t unsignedInteger=1; 
以 下 代码 会 在 ScriptC _script name.java 文件 中 被 生成 : 


private final static int mExportVarIdx_unsignedInteger=9; 
private long mExportVar_unsignedInteger; 
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if (mIOBuffer !=null) mIOBuffer-new FieldPacker (Item.sizeof * getType () .getX() /* count 
DES 


10.6 小 结 


本 章 简单 介绍 了 Android 系统 下 绘图 的 相关 方法 。Android 系统 提供 了 一 系列 方法 可 供 开发 者 
绘制 自己 所 需要 的 2D 或 者 3D 图 像 。 

2D 图 像 的 绘制 使 用 的 是 Canvas 类 对 象 ， 开 发 者 可 以 通过 该 对 象 在 自 定义 的 View 组 件 中 、 在 
新 建 的 Bitmap 对 象 中 或 者 SurfaceView 对 象 中 绘图 。 通常 情况 下 , View 组 件 和 Bitmap 对 象 适合 给 
制 静态 图 像 ，SurfaceView 适合 绘制 动态 图 像 。 利 用 这 一 点 ， 可 以 使 用 SurfaceView 进行 动画 或 者 
游戏 界面 的 绘制 。 

3D 图 像 的 绘制 使 用 的 是 OpenGL ES. OpenGL ES 是 OpenGL 技术 在 嵌入 式 平台 上 的 移植 版 本 ， 
借助 于 OpenGL ES 提供 的 相关 API 可 以 轻松 进行 3D 图 像 的 绘制 。 在 Android 平台 上 , 绘制 3D 图 
像 使 用 的 是 GLSurfaceView 组 件 和 GLSurfaceView.Renderer 泻 染 器 。 实 际 上 ，3D 图 像 的 绘制 是 一 
个 技术 含量 很 高 的 工作 ， 大 范围 地 应 用 于 3D 游戏 的 开发 中 。 本 章 篇 幅 有 限 ， 不 可 能 详细 描述 3D 
图 像 绘 制 的 内 容 ， 仅 希望 能 够 作为 将 读者 带 入 3D 绘图 技术 大 门 的 引路 石 。 

此 外 ， 由 于 图 形 绘制 过 程 中 需要 大 量 的 浮 点 数 运算 ， 而 Android 设备 本 身 计算 能 力 有 所 欠缺 ， 
因此 Android 平台 提供 了 硬件 加 速 功能 和 RenderScript 技术 用 于 处 理 计算 。 对 于 硬件 加 速 功 能 ， 应 
该 学 会 在 各 个 等 级 开关 相应 功能 以 提高 设备 的 绘图 能 力 。RenderScript 技术 非常 有 利于 图 形 计 算 ， 
但 是 由 于 其 运行 在 底层 ， 使 用 方式 和 正常 的 Android 框架 下 的 应 用 程序 有 所 不 同 。RenderScript 技 
术 是 仍 处 在 发 展期 的 技术 , 不 同 Android SDK 版 本 针对 该 技术 的 变换 比较 大 。 例如 , 在 Android 4.0 
版 本 中 的 RenderScriptGL 类 在 Android 4.1 版 本 中 就 被 弃 用 了 。 在 目前 阶段 ， 建 议 读者 对 该 技术 以 
了 解 为 主 。 





10.7 J 题 


1. 怎样 使 用 自 定 义 View 绘图 ? 

2. 怎样 使 用 Bitmap 绘图 ? 

3. 怎样 使 用 SurfaceView 绘制 静态 图 像 和 动态 图 像 ? 

4. 练习 分 别 使 用 资源 文件 、XML 和 构造 方法 创建 Drawable 对 象 。 


App 的 本 地 化 


11.1 国际 化 与 本 地 化 





国际 化 与 本 地 化 (Internationalization and localization) 是 指 调整 软件 ， 使 之 能 适用 于 不 同 的 语 











国际 化 是 指 在 设计 软件 的 过 程 中 将 软件 与 特定 语言 及 地 区 脱钩 的 过 程 。 当 软件 被 移植 到 不 同 
的 语言 及 地 区 时 ， 软 件 本 身 不 需要 做 任何 的 改变 或 修正 。 本 地 化 则 是 指 当 移 植 软件 到 不 同 的 语言 及 
地 区 时 ， 在 软件 内 部 加 上 与 特定 区 域 有 关 的 资讯 和 特色 的 过 程 。 国 际 化 意味 着 产品 有 适用 于 任何 区 
域 和 语言 的 能 力 ， 本 地 化 则 是 为 了 更 适合 特定 区 域 用 户 使 用 , 而 另外 增添 特色 。 在 软件 开发 过 程 中 ， 
国际 化 只 需 做 一 次 , 但 本 地 化 要 针对 每 个 不 同 的 区 域 分 别 做 一 次 。 对 于 软件 开发 人 员 来 说 ， 他 们 实 
现 的 是 软件 的 国际 化 ， 而 对 于 不 同 地 区 的 用 户 来 说 ， 他 们 感受 到 的 是 软件 的 本 地 化 。 

Internationalization (国际 化 ) 简称 “I18n”， 因 为 在 i 和 n 之 间 有 18 个 字符 ，Localization (本 
地 化 ) 简称 “L10n”。 一 般 说 明 一 个 地 区 的 语言 时 ， 用 “语言 地 区 ”的 形式 表示 ， 如 “zh_CN” 
表示 “汉语 _ 中国 大 陆地 区 ”， 即 简体 中 文 ; 而 “zh_TW” 表 示 “ 汉 语 _ 中国 台 湾 地 区 ”， 即 繁体 中 
X. 

Android 系统 框架 对 “Il18n” 和 “L10n” 提 供 了 非常 好 的 支持 。Android SDK 并 没有 提供 专门 
的 API 来 实现 国际 化 ， 而 是 通过 对 不 同 的 资源 resource 文件 进行 不 同 的 命名 来 达到 国际 化 的 目的 。 
同时 ， 这 种 命名 方法 还 可 用 于 对 硬件 的 区 分 ， 例 如 res/drawable 目录 下 的 三 个 文件 夹 
drawable-hdipi、drawable-ldpi 和 drawable-mdpi 就 是 为 了 适应 不 同 的 屏幕 分 辩 率 而 设立 的 。 
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11.2 手机 区 域 设置 


可 以 通过 手机 的 区 域 设置 获得 手机 的 本 地 化 功能 。 在 主 菜单 目录 下 ， 有 一 个 Custom Locale 应 
用 程序 ， 如 图 11.1 所 示 。 该 应 用 程序 用 于 对 手机 的 区 域 进行 设置 。 单 击 启动 该 应 用 程序 ， 运 行 效 
果 如 图 11.2 所 示 。 可 以 看 到 ， 默 认 情 况 下 ， 当 前 AVD 的 区 域 设 置 为 “en_US”， 即 语言 为 英语 ， 
区 域 ， 为 United States. 











[-] Custom Locale 


English (United States) 


en_NZ - English 


en_SG - English 


en_US - English 


Browser Calculator Calendar en-ZA- English 


[o p es - Spanish 
es_ES - Spanish 
Clock  CustomLoca Dev Tools Select Add 
'en US' New... 





图 11.1 主 菜单 图 11.2 Custom Locale 应 用 程序 
若 更 改 当 前 区 域 为 “zh CN”， 并 单 击 Select 'zh_CN ' 按 钮 ， 则 当前 手机 被 设置 为 汉语 ， 地 区 
为 中 国 大 陆地 区 ， 运 行 效果 如 图 11.3 所 示 ， 可 以 看 到 列表 中 的 部 分 语言 变 为 了 中 文 。 按 “ 回 退 ” 
键 回 到 主 菜 单 ， 发 现 很 多 应 用 程序 的 语言 都 变 为 了 中 文 ， 如 图 11.4 所 示 。 


# Custom Locale 
[Current Locale 000 
a) 


zh_CN -4 


uk UA - 乌克兰 文 
vi - 越南 文 


vi. VN - 越南 文 


zh_CN - 中 文 


zh_TW- 中 文 


Select 
"zh_CN' 





图 11.3 ”区域 设 置 为 “zh_ CN” 图 11.4 中文 效果 
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若 在 Custom Locale 列表 中 未 发 现 想 要 的 区 域 设 置 ， 则 可 以 自己 添加 。 单 击 Add New 按钮， 
弹出 如 图 11.5 所 示 的 对 话 框 ， 在 其 中 可 以 添加 自己 想 要 的 区 域 设置 选项 。 








Custom Locale 


New locale code: 


Add Add and 
Select 





图 11.5 添加 设置 对 话 框 


Android 7 平台 支持 的 “语言 地 区 ”列表 如 表 11.1 所 示 ， 凡 是 出 现在 该 列表 中 的 “语言 地 区 ” 
代码 都 可 以 被 Android 7 系统 直接 识别 。 


语言 地 区 

Arabic, Egypt (ar EG) 
Catalan, Spain (ca ES) 
German, Austria (de AT) 
German, Liechtenstein (de LI) 
English, Canada (en CA) 
English, India (en IN) 
English, US (en US) 
Spanish, US (es US) 
French, Canada (fr CA) 
Hebrew, Israel (he IL) 
Hungarian, Hungary (hu HU) 
Italian, Italy Cit IT) 
Lithuanian, Lithuania (lt LT) 


3k 11.1 Android 7 平台 支持 的 “语言 地 区 ”列表 


语言 地 区 
Arabic, Israel (ar IL) Bulgarian, Bulgaria (bg_BG) 
Czech, Czech Republic (cs CZ) Danish, Denmark (da DK) 


German, Switzerland (de CH) German, Germany (de DE) 





Dutch, Belgium (nl BE) 
Portuguese, Brazil (pt BR) 
Russian (ru RU) 

Serbian (sr RS) 


English, Australia (en AU) 
Spanish (es ES) 

Croatian, Croatia (hr HR) 
Latvian, Latvia (lv LV) Norway (nb NO) 
Swedish, Sweden (sv SE) Thai, Thailand (th TH) 





Tagalog, Philippines (tl PH) 


English, Britain (en GB) English, Ireland (en IE) 
Finnish, Finland (fi FD French, Belgium (fr BE) 
Indonesian, Indonesia (id ID) Italian, Switzerland (it CH) 
Portuguese, Portugal (pt PT) Romanian, Romania (ro RO) 
Turkish, Turkey (tr TR) Ukrainian, Ukraine (uk UA) 





Vietnamese, Vietnam (vi VN) 





English, New Zealand (en NZ) English, Singapore (en SG) 
French, Switzerland (fr CH) French, France (fr FR) 
Japanese (ja JP) Korean (ko KR) 

Slovak, Slovakia (sk SK) Slovenian, Slovenia (sl SD 
Chinese, PRC (zh_CN) Chinese, Taiwan (zh TW) 








11.3 未 本 地 化 的 应 用 程序 


在 本 书 之 前 章节 的 实例 中 均 未 涉及 本 地 化 的 问题 ， 在 此 我 们 先 看 一 下 未 本 地 化 的 应 用 程序 在 
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更 改 了 手机 的 区 域 设 置 后 运行 效果 会 有 什么 不 同 。 首 先 将 手机 区 域 设置 为 “zh CN”。 
新 建 一 个 Eclipse Android Project， 名 为 “L10NDemo”， 全 部 使 用 默认 设置 ， 不 修改 任何 代码 。 











成 后 ， 在 main.xml 文件 中 添加 如 下 代码 : 


<?xml version="1.0" encoding-"utf-8"?» 


<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 


android: orientation="vertical” 
android: layout_width="fill parent" 
android: layout_height="fill parent" 
> 
<TextView 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android: gravity="center horizontal" 
android: text="@string/text a" 
/> 
<TextView 
android: layout_width="fill parent" 
android: layout_height="wrap content" 
android: gravity="center horizontal" 
android:text="@string/text_b" 
/> 
<Button 
android: id="@+id/flag button" 
android: layout_width="wrap_ content" 
android: layout_height="wrap content" 
android: layout_gravity="center" 
/» 
</LinearLayout> 


Main.xml 采用 LinearLayout 布局 ， 分 别 放 置 了 两 个 TextView 和 一 个 Button, 


这 是 默认 的 strings.xml 资 源 文件 
这 是 中 国 国旗 





图 11.6 默认 设置 的 运行 效果 
Main.xml 所 使 用 的 资源 文件 res/values/strings.xml 的 代码 如 下 : 


如 图 11.6 所 示 。 
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<?xml version="1.0" encoding-"utf-8"?» 
<resources> 
<string name-"app name">L10NDemo</string> 
«string name-"text a"> 这 是 默认 的 strings.xml 资源 文件 </string> 
«string name-"text b"> 这 是 中 国 国旗 </string> 
«string name="dialog title"> 未 本 地 化 </string> 
<string name="dialog text"> 本 对 话 框 中 的 内 容 没有 本 地 化 ， 相 关 资 源 来 自 values/strings.xml。</string> 


</resources> 


“LI10NDemo” 的 主 Activity 4 L10NDemoActivity, L10NDemoActivity.java 的 代码 如 下 : 


package introduction.android.110nDemo; 


import android.app.Activity; 

import android.app.AlertDialog; 

import android.content.DialogInterface; 
import android.os.Bundle; 

import android.view.View; 

import android.widget.Button; 


public class L10NDemoActivity extends Activity { 

/** Called when the activity is first created. */ 

@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) ; 
setContentView (R.layout.main) ; 
Button b; 

(b= (Button) findViewById (R.id.flag button)) .setBackgroundDrawable 

(this.getResources().getDrawable (R.drawable.flag)) ; 

// build dialog box to display when user clicks the flag 
AlertDialog.Builder builder-new AlertDialog.Builder (this) ; 
builder.setMessage (R.string.dialog text) 

-setCancelable (false) 

.setTitle (R.string.dialog title) 

.SetPositiveButton ("Done", new DialogInterface.OnClickListener () { 
public void onClick (DialogInterface dialog, int id) { 
dialog.dismiss(); 

5 
D: 
final AlertDialog alert=builder.create(); 
// set click listener on the flag to show the dialog box 
b.setOnClickListener (new View.OnClickListener()( 

public void onClick (View v) ( 

alert.show(); 


Ds 
} 


L10NDemoActivity 为 main.xml 中 的 Button 设置 了 一 幅 图 像 ， 是 R.drawable.flag 指向 的 图 像 文 
件 。 当 用 户 单 击 Button 时 ， 即 可 弹出 一 个 有 Done 按钮 的 AlertDialog， 显 示 R.string.dialog text 指 
向 的 内 容 ， 运 行 效果 如 图 11.7 所 示 。 
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L10NDemo 


本 对 话 框 中 的 内 容 没 有 本 地 
化 ， 相 关 资源 来 自 values/ 
strings.xml。 


Done 





图 11.7 ”按钮 修改 的 运行 效果 


然后 将 手机 区 域 设置 修改 为 “en_US”， 即 美式 英语 。 再 次 运行 该 实例 ， 运 行 效果 如 图 11.8 
所 示 。 再 将 手机 区 域 设置 为 其 他 区 域 ， 运 行 效果 不 变 。 


| LoNDemo 


SPA UD be! 
， 相关 资源 来 自 values/ 


xml, 


Done 





图 11.8 区域 修 改 的 运行 效果 


可 见 实例 “L10NDemo” 在 不 同 的 区 域 设置 下 ， 运 行 效果 完全 相同 。 这 是 因为 Android 系统 对 
于 未 实现 本 地 化 的 应 用 程序 ， 均 使 用 默认 的 资源 文件 ， 无 论 当前 手机 设备 被 设置 为 任何 地 区 ， 应 用 
程序 的 运行 效果 都 相同 。 


11.4 本 地 化 的 应 用 程序 


本 节 我 们 尝试 将 LI0NDemo 实例 本 地 化 。 为 L10NDemo 工程 添加 汉语 、 德 语 、 日 语 、 英 语 支持 。 
语言 国家 和 为 其 所 建立 的 资源 文件 夹 的 对 应 关系 如 表 11.2 所 示 。 
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表 11.2 语言 国家 和 资源 文件 夹 的 对 应 关系 表 
Locale Code Language / Country Location of strings.xml Location of flag.png 
Default Chinese / china tes/values/ tes/drawable/ 
zh-rCN Chinese / china Tes/values-zh-rCN res/drawable/ 


French / France res/values-fr/ res/drawable-fr/ 














Japanese / Japan res/values-ja/ 1es/drawable-ja-rJP/ 


en-rUS English / United States (res/values/) res/drawable-en-rUS/ 











€D) 在 tes 目录 上 右 击 ， 选 择 New| Android XML File， 如 图 11.9 所 示 。 在 弹出 的 对 话 框 中 设 
Resource Type A Values. Project 为 工 10NDemo”、 文 件 名 为 “stringsxml”， 然 后 单 击 Next 按钮 。 














(8 New Android XML File cma] 
PETERE 

Resource Type: (Values. =] 
Project: L10NDemo. x) 
File: ting 

Bresources 

四 Ge Gee Ge) 

















图 11.9 New Android XML File 对 话 框 


出 现 文件 夹 配置 对 话 框 ， 如 图 11.10 所 示 。 
[rewan se ———————— — — — Linien) 


Choose Configuration Folder © 


Optional: Choose a specific configuration to limit the XML to: 
‘Available Quali. > lees 
cout Code 
Network Code 
asmaten sere- | | 
ose Width |e] I 
L Sereen Height | | [i] 
PlSze I 
EnRatic 

Porentaton 

BU Mode 

Niche Mode 

图 Densty 

[P'Touch Sereen = 











Folder jresivalues-zh-rCN 


i 
i 
i 

















图 11.10 文件 夹 配置 对 话 框 
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Eo MENR ARE | 然后 单 击 “->” 按 钮 为 语言 填写 两 个 字符 的 代码 zh, 
从 左 侧 列表 选择 [Sesse，]， 单 击 “->” 按 钮 ， 为 地 区 填写 两 个 字符 的 代码 CN, Sai Finish 按钮 。 
Eclipse 即 可 在 res 目录 下 建立 values-zh-rCN 文件 夹 ， 该 文件 夹 下 的 strings. xml 用 以 存放 区 域 设置 为 
“zh_CN ”的 相关 资源 文件 。 


res/values-zh-rCN/strings. xml 文件 的 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 
«string name="app_name">L10NDemo</string> 
«string name="text a"»iXfÉ values-zh-rCN 的 strings.xml 资源 文件 </string> 
<string name="text_b"> 这 是 中 国 国旗 </string> 
«string name-"dialog title"> 已 经 本 地 化 </string> 
«string name="dialog_text"> 对 话 框 中 的 字符 串 已 经 本 地 化 ， 所 使 用 资源 来 自 values-zh-rCN/strings.xml 资源 文 
件 。</string> 
</resources> 


C€X303 依照 同样 的 步骤 为 res SCÓEZRIBSCÉESE values-en-+US, values-fr 和 values-ja， 并 创建 
对 应 的 sting xml 文件 。 


res/values-en-rUS/strings.xml 文件 的 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<string name="app name">L10NDemo</string> 
<string name="text a">local values from values-en-rUS/strings.xml</string> 
<string name="text b"»This is the flag of America.</string> 
<string name-"dialog title">Localised</string> 





<string name="dialog text">This dialog box"'"s strings are localised. For every locale, the text 
here will come from values-en-rUS/strings.xml.</string> 
</resources> 


res/values-fr /strings.xml 文件 的 内 容 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«resources» 

<string name-"app name">Bonjour, Localisation</string> 

<string name="text_a">Irai-je te comparer au jour</string> 

<string name="text b"»Tu es plus tendre et bien plus tempéré.</string> 
</resources> 


res/values-ja/strings.xml 文件 的 内 容 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 

<resources> 
«string name="text a >bHereaecmcrer~zSeLR5HQO-ACL + 9m? </string> 
«string name="text_b™>RMbeKbotRL <4. tot Bib ct. «string» 


</resources> 
CX304 依照 同样 的 步骤 在 LIONDemo 工程 的 res 目录 下 添加 drawable-en-+US, drawable-fr, 


drawable-ja-rJP 目录 ， 并 将 美国 、 法 国 和 日 本 的 国旗 图 标 分 别 复制 到 对 应 文件 夹 下 。 此 时 ， 工 程 
L10NDemo 的 res 目录 结构 如 图 11.11 所 示 。 
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& res 


© drawable-en-rUS 
Ws flag.png 
© drawable-fr 
i flag.png 
© drawable-hdpi 
© drawable-ja-rJP 
Bi flag.png 
© drawable-Idpi 
© drawable-mdpi 
© layout 
X mainxxml 
@ values 
X, stringsxml 
© values-en-rUS 
X, stringsxml 
© values-fr 
X, strings.xml 
© values-ja 
X, stringsxml 
© values-zh-rCN 
X, stringsxml 





图 11.11 LIONDemo 的 res 目录 结构 


至 此 ， 实 例 LIONDemo 的 开发 过 程 结束 。 下 面 更 改 手机 的 区 域 配置 ， 运 行 应 用 程序 ， 查 看 运 
行 效果 。 
将 区 域 配置 修改 为 “en US”， 运 行 效果 如 图 11.12 所 示 。 


| Liondemo 


This dialog box's strings are 


localised. For every locale, the 
text here will come from values- 
en-rUS/strings.xml. 


Done 





图 11.12 设置 “en US” 区 域 的 运行 效果 


由 运行 效果 可 见 ， 视 图 中 的 两 个 TextView 以 及 对 话 框 内 的 字符 串 都 已 经 本 地 化 ， 来 自 
values-en-rUS/strings.xml 文件 ， 按 钮 上 的 美国 国旗 图 标 来 自 drawable-en-rUS/flag.png 文件 。 
将 区 域 修改 为 “zh CN”， 运 行 效果 如 图 11.13 所 示 。 
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BB Liondemo 


这 是 values 


对 话 框 中 的 字符 串 已 经 本 地 


化 ， 所 使 用 资源 来 自 values-zh- 


rCN/strings.xml 资 源 文件 。 


Done 


图 11.13 设置 “zh_ CN” 区 域 的 运行 效果 


由 运行 效果 可 见 ， 视 图 中 的 两 个 TextView 以 及 对 话 框 
L10NDemo 中 并 没有 建立 drawable-zh-rCN 文件 夹 ， 按 钮 上 的 中 





" 


2l 


字符 串 都 已 
文件 夹 。 

















zi 
四 





将 区 域 修改 为 位 ， 运 行 效果 如 图 11.14 所 示 


P Bonjour, Localisation 


本 对 话 框 中 的 内 容 没 有 本 地 
化 ， 相 关 资 源 来 自 values/ 
strings.xml。 





图 11.14 BE fr 区域 的 运行 效果 
由 运行 效果 可 见 ， 视 图 中 的 











values/strings.xml 文件 中 的 dialog text 变量 。 按钮 
将 区 域 修改 为 ja， 运 行 效果 如 图 11.15 所 示 。 




















上 的 法 国 国旗 图 标 3 




















经 本 地 化 。 实 例 
旗 图 标 来 自 默 认 资源 drawable 





两 个 TextView 以 及 应 用 程序 的 标题 都 已 经 本 地 化 
values-fr/strings.xml 文件 中 未 包含 dialog text 变量 


日 于 





因此 文本 框 内 的 内 容 未 被 本 地 化 ， 而 是 使 














标 来 自 drawable-fr/flag.png 文件 


f 
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本 对 话 框 中 的 内 容 没 有 本 地 


化 ， 相 关 资 源 来 自 values/ 
strings.xml, 


Done 





图 11.15 设置 “ja” 区 域 的 运行 效果 


由 运行 效果 可 见 ， 视 图 中 的 两 个 TextView 已 经 本 地 化 。 由 于 values-ja/strings.xml 文件 中 未 包 
& app name 和 dialog text 变量 ， 因 此 文本 框 内 的 内 容 和 应 用 程序 标题 都 未 被 本 地 化 ， 而 是 使 用 了 
values/strings.xml 文件 中 的 dialog text 变量 。 虽 然 实例 LIONDemo 中 建立 了 drawable-ja-rJP 文件 
KK 并 提供 了 flag.png 文 伟 但 是 由 于 “-ja-rJP” 后 级 与 “-ja” 
后 缀 不 一 致 ， 因 此 未 能 载 入 日 本 国旗 图 标 ， 而 是 使 用 了 默认 
的 drawable/flag.png 文件 。 Lal 

将 区 域 修改 为 “ja-JP”， 可 以 和 drawable-ja-rJP 目录 项 
匹配 ， 日 本 国旗 图 标 被 载 入 应 用 程序 中 。 而 字符 串 资源 
“values-ja” 虽 然 和 当前 区 域 不 在 同一 个 地 区 ， 但 也 被 正常 载 
入 。 这 是 因为 “values-ja” 仅 指定 了 语言 ， 而 没有 指定 地 区 ， 
因此 该 目录 下 的 资源 文件 可 以 被 所 有 语言 为 日 语 的 区 域 所 使 
用 。 运 行 效果 如 图 11.16 所 示 。 

Android 系统 根据 资源 文件 的 后 级 名 来 实现 应 用 程序 的 
国际 化 。 当 手机 被 指定 为 某 个 特定 区 域 后 ， 应 用 程序 自动 读 
取 对 应 后 绥 的 文件 夹 下 的 资源 文件 ， 更 新 应 用 程序 界面 ， 达 
到 本 地 化 的 目的 。 当 某 资 源 目 录 仅 指定 了 语言 而 没有 指定 地 
区 时 ， 该 资源 可 以 被 所 有 使 用 该 语言 的 地 区 使 用 。 

在 每 个 区 域 的 本 地 化 资源 文件 中 ， 不 需要 包含 所 有 的 本 
地 化 资源 ， 而 只 需 定义 与 默认 资源 不 同 的 本 地 化 资源 即 可 。 当 在 特定 区 域 的 资源 文件 中 找 不 到 对 应 
的 本 地 化 资源 时 ，Android 系统 会 自动 使 用 默认 的 资源 文件 。 
因此 ，Android 系统 要 求 工 程 运行 所 需 的 所 有 默认 的 资源 都 必须 存在 。 若 应 用 程序 中 缺少 某 个 
默认 资源 ， 则 当 手 机 设备 被 设置 为 不 支持 的 语言 区 域 时 ， 应 用 程序 将 不 能 运行 。 例 如 ， 
res/values/strings.xml 中 缺少 了 应 用 程序 运行 所 需 的 某 一 个 字符 串 变 量 , 当 应 用 程序 被 设置 为 不 支持 
的 地 区 ， 尝 试 载 入 该 默认 资源 时 ,会 出 现 致命 错误 。 用户 会 看 到 提示 应 用 程序 错误 的 信息 和 强制 关 
闭 应 用 程序 的 按钮 。 这 种 错误 不 会 被 Eclipse 检查 出 来 ， 并 且 当 应 用 程序 运行 于 支持 的 地 区 时 ， 





ONDemo 








图 11.16 设置 “ja-JP” 区 域 的 运行 效果 
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该 错误 也 不 会 被 发 现 。 这 就 要 求 程序 开发 人 员 在 进行 应 用 程序 国际 化 开发 时 格外 小 心 ， 避 免 这 种 
错误 。 


11.5 小 结 




















国际 化 与 本 地 化 是 应 用 程序 开发 过 程 中 很 重要 的 一 部 分 。 借 助 于 国际 化 ， 可 以 让 我 们 开发 的 
应 用 程序 无 须 做 任何 修改 即 可 在 各 种 语言 环境 中 运行 。Android 框架 对 国际 化 和 本 地 化 提供 了 很 好 
的 支持 ， 通 过 资源 文件 夹 后 绥 的 匹配 来 完成 应 用 程序 的 本 地 化 工作 ， 该 匹配 过 程 无 须 开发 人 员 参 
与 ， 由 Android 系统 自动 完成 。 

Android 系统 的 本 地 化 工作 步骤 简单 ， 易 于 完成 ， 但 其 中 有 很 多 技巧 需要 读者 在 学 习 过 程 中 慢 
慢 积累 。 











11.6 J 题 


1. 如 果 仅 使 用 默认 的 资源 文件 ， 当 手机 区 域 设 置 改 变 时 ， 应 用 程序 会 怎样 ? 

2. 如 果 不 使 用 资源 文件 , 而 直接 将 视图 中 的 字符 串 写 在 布局 文件 里 ， 当 手机 切换 区 域 设置 时 ， 
应 用 程序 会 怎样 ? 

3. 在 本 地 化 过 程 中 ， 若 缺少 了 某 个 默认 资源 ， 应 用 程序 会 怎样 ? 

4. 当 手 机 的 区 域 设置 为 “你 CA”， 某 资源 目录 为 “values-f” 时 ， 该 资源 在 什么 情况 下 会 被 
载 入 ? 

5. 手机 的 区 域 设置 为 “位 CA”, 资源 目录 为 “values-fr-rFR”, 该 目录 下 的 资源 能 否 被 载 入 ? 


文本 与 输入 


Android 7.0 提供 的 文本 服务 可 以 为 应 用 程序 添加 诸如 复制 /粘贴 、 检 查 拼 写 等 功能 。 用 户 也 可 
以 开发 自己 的 文本 服务 , 像 其 他 应 用 程序 一 样 分 发 给 其 他 用 户 , 文本 服务 具有 自 定义 的 输入 法 编辑 
器 (ME) 、 字 典 和 拼写 检查 器 。 

本 章 仅 对 文本 的 复制 和 粘贴 服务 进行 介绍 。 

Android 为 复制 和 粘贴 提供 了 强大 的 、 基 于 剪贴 板 的 框架 。 它 支持 多 种 数据 类 型 ， 包 括 文本 字 
符 串 、 复 杂 的 数据 结构 、 文 本 和 二 进 制 数 据 流 ， 甚 至 其 他 复杂 的 应 用 类 型 。 简 单 的 文本 数据 被 保存 
在 剪贴 板 中 , 而 复杂 的 数据 会 保存 成 一 个 引用 ,粘贴 应 用 程序 会 使 用 Content Provider 解析 该 引用 。 
复制 和 粘贴 工作 可 以 在 应 用 程序 内 部 进行 ， 也 可 以 在 实现 该 框架 的 两 个 应 用 程序 之 间 进 行 。 


12.1 ”剪贴 板 框架 


使 用 剪贴 板 框架 〈Clipboard Framework) 时 ， 把 数据 放 在 一 个 前 切 对 象 Clip object) 中 ， 这 
个 对 象 会 自动 放 在 系统 的 剪贴 板 中 。 

前 切 对 象 有 以 下 三 种 形式 。 

(1) Text 

这 种 形式 下 ， 字 符 串 被 直接 放 在 前 切 对 象 中 ， 然 后 放 在 剪贴 板 里 。 粘 贴 这 个 字符 串 的 时 候 ， 
直接 从 剪贴 板 取出 这 个 对 象 ， 把 字符 串 放 入 应 用 存储 中 。 

(2) URI 

可 以 表示 任何 形式 的 URI。 这 种 形式 主要 用 于 从 一 个 Content Provider 中 复制 复杂 的 数据 。 复 
制 的 时 候 把 一 个 URI 对 象 放 在 一 个 剪 切 对 象 中 ， 再 放 在 剪贴 板 里 。 粘 贴 的 时 候 取出 这 个 前 切 对 象 ， 
得 到 URI， 把 它 解 析 为 一 个 数据 资源 ， 比 如 Content Provider， 然 后 从 资源 中 复制 数据 到 应 用 存储 中 。 
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(3) Intent 

它 支 持 复制 应 用 程序 的 快捷 方式 。 要 复制 这 种 数据 ， 就 要 创建 一 个 Intent 对 象 , 把 它 放 到 一 个 
剪 切 对 象 中 , 并 将 这 个 剪 切 对 象 放 到 系统 剪贴 板 上 。 粘贴 数据 时 , 要 从 剪贴 板 上 获取 这 个 剪 切 对 象 ， 
然后 把 这 个 Intent 对 象 放 到 应 用 程序 的 内 存 中 。 

系统 剪贴 板 每 次 仅 有 一 个 剪 切 对 象 ， 当 一 个 应 用 程序 把 一 个 剪 切 对 象 放 到 剪贴 板 上 时 ， 前 一 
个 剪 切 对 象 就 会 消失 。 

如 果 人 允许 用 户 把 数据 粘贴 到 应 用 程序 中 ， 可 以 在 粘贴 之 前 检查 剪贴 板 上 的 数据 ， 而 不 必 处 理 
所 有 的 数据 类 型 。 剪 切 对 象 包 含 MIME 类 型 或 可 用 类 型 的 元 数据 ， 这 个 元 数据 会 帮助 我 们 判断 应 
用 程序 是 否 可 以 使 用 剪贴 板 上 的 数据 。 例 如 ， 如 果 想 要 处 理 文本 ， 可 以 忽略 包含 URI BK Intent 对 
象 的 前 切 对 象 。 如 果 让 用 户 粘 贴 文本 ， 而 不 管 剪贴 板 上 的 数据 格式 ， 可 以 强制 把 剪贴 板 数据 转换 成 
文本 形式 ， 然 后 粘贴 这 个 文本 。 





12.2 剪贴 板 类 


本 节 主 要 描述 剪贴 板 框架 中 所 使 用 的 类 。 
1. 剪贴 板 管理 器 


在 Android 系统 中 ， 系 统 前 贴 板 由 全 局 ClipboardManager (剪贴 板 管理 器 ) 类 表示 。 此 类 不 需 
要 直接 初始 化 创建 对 象 ， 而 是 通过 getSystemService(CLIPBOARD SERVICE) 方 法 获取 一 个 引用 。 


2. ClipData、ClipData.ltem 和 ClipDescription 


要 把 数据 加 入 剪贴 板 ， 可 以 创建 一 个 ClipData 对 象 ， 它 包含 数据 描述 信息 和 数据 本 身 。 剪 贴 
板 每 次 只 保存 一 个 ClipData 对 象 ， 一 个 ClipData 对 象 包含 一 个 ClipDescription 对 象 和 一 个 以 上 的 
ClipData.Item 对 象 。 
(1) ClipDescription 
ClipDescription 对 象 包含 clip 相关 的 元 数据 信息 。 需 要 特别 指出 的 是 ， 它 包含 一 个 clip 数据 所 
对 应 MIME 类 型 的 数组 。 把 clip 放 入 剪贴 板 后 ， 粘 贴 应 用 程序 时 可 以 利用 此 数组 ， 程 序 可 以 检查 
该 数组 ， 以 确定 其 对 这 些 MIME 类 型 的 处 理 能 力 。 
(2) ClipData.Item 
clipdata.Item 对 象 包含 Text, URI 和 Intent 数据 。 
() Text 
文本 ， 就 是 一 个 字符 序列 。 
®© URI 
虽然 可 以 取 任 何 URI 值 ， 但 通常 包含 一 个 Content Provider URI。 提 供 数据 的 应 用 程序 把 URI 
放 入 剪贴 板 ， 需 要 粘贴 数据 的 应 用 程序 从 剪贴 板 中 获取 URI, 并 将 它 用 于 访问 Content Provider (或 
者 其 他 数据 源 ) 并 取 回 数据 。 
(3) Intent 
本 数据 类 型 允许 把 应 用 程序 的 快捷 方式 复制 到 剪贴 板 中 ， 用 户 可 以 在 后 续 的 使 用 中 把 快捷 方 
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式 粘 贴 到 其 他 应 用 程序 中 。 

在 一 个 clip 中 可 以 包含 一 个 或 多 个 Item 对 象 。 这 使 得 用 户 可 以 把 多 个 选中 的 值 复制 到 同一 个 
clip 中 。 比如,， 有 一 个 列表 允许 用 户 一 次 选择 多 个 选项 , 可 以 把 所 有 选中 的 项 一 次 复制 到 剪贴 板 中 。 
要 实现 这 一 点 ， 先 为 列表 每 一 项 创建 一 个 ClipDataItem 对 象 ， 再 把 这 些 ClipData.Item 对 象 加 入 
ClipData 对 象 即 可 。 

(3) ClipData 的 简便 方法 

ClipData 类 为 创建 具有 一 个 简单 的 Clipdata.item 和 ClipDescription 对 象 的 ClipData 对 象 提供 一 
些 简 便 的 静态 方法 。 

(D newPlainText(label, text) 

该 方法 返回 包含 单个 ClipData.Item 对 象 的 ClipData WR, iZ item 对 象 内 含 一 个 文本 字符 串 ， 
ClipDescription 对 象 的 标签 设置 为 label 时 ，ClipDescription 的 MIME 类 型 是 MIMETYPE TEXT 
PLAIN。 

newPlainTextO 可 用 于 创建 一 个 文本 字符 串 clip. 

(2) newUri(resolver, label, URI) 

该 方法 也 返回 一 个 包含 单个 ClipData.Item 的 ClipData 对 象 , 该 item 对 象 内 含 一 个 URI。 其 中 ， 
ClipDescription 对 象 的 标签 设置 为 label。 若 URI 是 content 类 型 〈Uri.getSchemeO 返 回 content:) ， 
则 该 方法 将 用 resolver 的 ContentResolver 对 象 从 Content Provider 中 获取 可 用 的 MIME 类 型 ， 并 把 
这 些 类 型 保存 到 ClipDescription 中 。 对 于 不 是 content 的 URI ， 该 方法 把 MIME 类 型 设置 为 
MIMETYPE TEXT URILIST. 

newUriO 用 于 创建 一 个 URI 的 clip， 特 别 是 content: URI. 

(8) newIntent(label, intent) 

该 方法 也 返回 一 个 包含 单个 ClipData.Item 的 ClipData 对 象 ， 该 item 对 象 内 含 一 个 Intent。 其 
中 ，ClipDescription 对 象 的 标签 设置 为 label，MIME 类 型 置 为 MIMETYPE TEXT INTENT. 

newIntentO 用 于 创建 一 个 Intent 对 象 的 剪贴 对 象 。 

















12.3 将 剪贴 板 内 的 数据 强制 转换 为 文本 


如 果 应 用 程序 只 能 处 理 文本 ， 可 用 ClipDataItem.coerceToText() 方 法 进行 转换 ， 就 可 以 从 剪贴 
板 上 复制 非 文本 数据 。 
这 种 方法 将 把 ClipDataItem 中 的 数据 转换 为 文本 ， 并 且 返 回 一 个 CharSequence 对 象 。 
ClipData.Item.coerceToTextO 的 返回 值 依据 ClipData.Item 中 的 数据 格式 来 确定 。 
(1) Text 
若 ClipData.Item 是 文本 (getText0 不 为 null) ， 则 coerceToText0 返 回 文本 。 
(2) URI 
4; ClipData.Item 是 一 个 URI(CgetUri0 不 为 null), 则 coerceToText0 会 尝试 将 其 视 为 Content URI. 
(D 若 URI 是 一 个 Content URI H. Provider 能 返回 文本 流 ， 则 coerceToText0 返 回 文 本 流 。 
© 若 URI 是 一 个 Content URI 但 Provider 无 法 提供 文本 流 ， 则 coerceToText0 返 回 URI 的 字 
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符 串 表示 形式 ， 该 字符 串 表 示 形 式 与 Uri.toString0 的 返回 值 一 致 。 
© # URI 不 是 一 个 Content URI, Jl] coerceToText0 返 回 URI 的 字符 串 表 示 形 式 ， 该 字符 串 表 
示 形 式 与 Uri.toString0 的 返回 值 一 致 。 
(3) Intent 
如 果 ClipData.Item 是 一 个 Intent( getIntent() 4^ 7J null), 则 coerceToText() 将 其 转换 为 Intent URI 
后 返回 。 该 字符 串 表示 形式 与 Intent.toUri(URI INTENT_SCHEME) 的 返回 值 一 致 。 
剪贴 板 的 整体 框架 如 图 12.1 所 示 。 











图 12.1 Android 剪贴 板 框架 


复制 数据 时 ， 应 用 程序 将 ClipData 对 象 放 入 全 局 的 ClipboardManager 剪贴 板 中 。ClipData 内 
含 一 个 或 多 个 ClipData.Item 对 象 以 及 一 个 ClipDescription 对 象 。 粘 贴 数据 时 ， 应 用 程序 先 获 取 
ClipData， 从 ClipDescription 中 读 取 MIME 类 型 信息 ， 再 从 ClipData Item 中 或 ClipData.Item 指向 
的 Content Provider 中 读 取 数据 。 


12.4 复制 到 剪贴 板 


如 前 面 所 述 ， 如 果 要 把 数据 复制 到 剪贴 板 〈 剪 贴 板 句柄 指向 全 局 的 ClipboardManager 对 象 ) 
上 ， 需 要 创建 一 个 ClipData 对 象 ， 再 把 一 个 ClipDescription 和 一 个 以 上 的 ClipData Item 对 象 加 入 
其 中 ， 最 后 把 这 个 ClipData 添加 到 ClipboardManager 对 象 中 去 。 

具体 的 实现 过 程 如 下 : 

要 复制 Content URI 类 型 的 数据 ， 先 要 建立 一 个 Content Provider。 

NotePad 是 一 个 使 用 Content Provider 复制 粘贴 数据 的 示例 。NotePadProvider 类 实现 了 Content 
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Provider. NotePad 类 定义 了 该 Provider 和 其 他 应 用 程序 的 交互 方式 ,包括 支持 所 用 的 MIME 类 型 。 


CL) 获取 系统 剪贴 板 。 
其 代码 如 下 : 


// if the user selects copy 
case R.id.menu_copy: 


// Gets a handle to the clipboard service. 
ClipboardManager clipboard = (ClipboardManager) 
getSystemService(Context.CLIPBOARD SERVICE); 


(2) 复制 数据 给 一 个 ClipData 对 象 。 
(QD 文本 
如 果 数 据 是 一 个 文本 ， 代 码 如 下 : 


// Creates a new text clip to put on the clipboard 


ClipData clip = ClipData.newPlainText ("simple text","Hello, World!"); 


@ URI 


如 果 数 据 是 一 个 URI 对 象 ， 把 记录 ID Hii Provider 用 到 的 Content URI 中 的 代码 如 下 : 


// Creates a Uri based on a base Uri and a record ID based on the contact's last name 


// Declares the base URI string 


private static final String CONTACTS = "content://com.example.contacts"; 


// Declares a path string for URIs that you use to copy data 


private static final String COPY_PATH = "/copy"; 


// Declares the Uri to paste to the clipboard 


Uri copyUri = Uri.parse (CONTACTS + COPY PATH + "/" + lastName); 


// Creates a new URI clip object. The system uses the anonymous getContentResolver() object to 
// get MIME types from provider. The clip object's label is "URI", and its data is 


// the Uri previously created. 


ClipData clip = ClipData.newUri (getContentResolver (),"URI", copyUri) ; 


(3) Intent 


如 果 数 据 是 一 个 Intent 对 象 ， 将 其 放 入 clip 对 象 中 的 代码 如 下 : 


// Creates the Intent 


Intent appIntent = new Intent(this, com.example.demo.myapplication.class) ; 


// Creates a clip object with the Intent in it. Its label is "Intent" and its data is 


// the Intent object created previously 
ClipData clip = ClipData.newIntent ("Intent",appIntent); 


把 新 建 的 clip 对 象 放 入 剪贴 板 的 代码 如 下 : 


412 | Android 7 应 用 程序 开发 教程 





// Set the clipboard's primary clip. 
clipboard. setPrimaryClip (clip); 


12.5 “从 剪贴 板 中 粘贴 


如 前 面 所 述 ， 要 从 剪贴 板 粘贴 数据 ， 需 先 获得 全 局 剪贴 板 对 象 ， 再 获取 clip 对 象 ， 查 找 其 中 
的 数据 , 最 后 从 clip 对 象 中 把 数据 复制 到 自己 的 存储 中 。 本 节 将 详细 描述 如 何 针对 三 种 剪贴 板 数据 
的 格式 进行 这 些 操作 。 

1. 粘贴 普通 文本 

要 粘贴 普通 文本 ， 首 先 获 得 全 局 剪贴 板 ， 并 确认 能 否 返 回 普通 文本 ， 然 后 获取 clip WR, HA 
getTextO 把 其 中 的 文本 复制 到 自己 的 存储 中 。 实 现 步骤 如 下 : 


€o) 用 xetSystemService(CLIPBOARD SERVICE) 获 得 全 局 ClipboardManager 对 象 ， 并 声 
明 一 个 全 局 变量 ， 用 来 存放 粘贴 到 的 文本 。 


ClipboardManager clipboard = (ClipboardManager) getSystemService (Context .CLIPBOARD SERVICE); 


String pasteData = ""; 


CHO? 确定 启用 或 禁用 当前 Activity 的 “粘贴 ”选项 ， 并 验证 剪贴 板 中 是 否 包含 clip， 且 程 
序 是 否 有 能 力 处 理 其 数据 类 型 。 


// Gets the ID of the "paste”menu item 
Menultem mPasteItem = menu.findItem(R.id.menu paste); 


// If the clipboard doesn't contain data, disable the paste menu item. 
// If it does contain data, decide if you can handle the data. 
if (!(clipboard.hasPrimaryClip())) { 
mPastelItem.setEnabled(false); 
} else if (!(clipboard.getPrimaryClipDescription().hasMimeType (MIMETYPE TEXT PLAIN))) { 
// This disables the paste menu item, since the clipboard has data but it is not plain text 
mPasteItem.setEnabled (false); 


} else { 


// This enables the paste menu item, since the clipboard contains plain text. 
mPasteItem.setEnabled (true); 


En 从 剪贴 板 中 复制 数据 。 只 有 “粘贴 ”菜单 项 启用 时 ， 程 序 才 会 运行 至 此 ， 所 以 这 时 可 
以 假定 剪贴 板 已 经 包含 普通 文本 ， 不 过 还 不 清楚 里 面包 含 文本 字符 串 还 是 指向 普通 文本 的 URI。 测 
试 处 理 普通 文本 的 部 分 代码 如 下 : 


// Responds to the user selecting “paste” 
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case R.id.menu_paste: 


// Examines the item on the clipboard. If getText() does not return null, the clip item contains 
the 

// text. Assumes that this application can only handle one item at a time. 

ClipData.Item item = clipboard.getPrimaryClip() .getItemAt (0); 


// Gets the clipboard as text. 
pasteData = item.getText(); 


// If the string contains data, then the paste operation is done 
if (pasteData != null) { 


return; 


// The clipboard does not contain text. If it contains a URI, attempts to get data from it 
} else { 
Uri pasteUri = item.getUri(); 


// If the URI contains something, try to get text from it 
if (pasteUri !- null) ( 


// calls a routine to resolve the URI and get data from it. This routine is not 
// presented here. 
pasteData = resolveUri (Uri); 
return; 
} else { 


// Something is wrong. The MIME type was plain text, but the clipboard does not contain either 
// text or a Uri. Report an error. 

Log.e("Clipboard contains an invalid data type"); 

return; 


} 


2. M Content URI 粘贴 数据 


如 果 ClipData.Item 对 象 包含 一 个 Content URI， 程 序 也 能 处 理 其 中 的 MIME 类 型 ， 可 创建 一 
个 ContentResolver 对 象 ， 并 调用 Content Provider 的 相关 方法 来 获取 数据 。 

以 下 过 程 描述 了 如 何 根据 剪贴 板 中 的 Content URI 从 Content Provider 获取 数据 。 

COD 声明 全 局 变量 ， 用 于 存放 MIME 类 型 。 

程序 先 检查 MIME 类 型 ， 确 认 能 够 使 用 Provider 提供 的 数据 。 


// Declares a MIME type constant to match against the MIME types offered by the provider 
public static final String MIME TYPE CONTACT = "vnd.android.cursor.item/vnd.example.contact" 


(2) 获取 全 局 前 贴 板 ， 创 建 一 个 用 于 访问 Content Provider 的 Content Resolver 对 象 。 


// Gets a handle to the Clipboard Manager 
ClipboardManager clipboard = (ClipboardManager) getSystemService(Context.CLIPBOARD SERVICE); 


// Gets a content resolver instance 


ContentResolver cr = getContentResolver():; 


G) 从 剪贴 板 获取 主 clip， 并 把 内 容 解析 为 URI。 
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// Gets the clipboard data from the clipboard 
ClipData clip = clipboard.getPrimaryClip(); 


if (clip != null) { 


// Gets the first item from the clipboard data 
ClipData.Item item = clip.getItemAt (0); 


// Tries to get the item's contents as a URI 
Uri pasteUri = item.getUri(); 


(4) 通过 调用 getType(UrD， 判 断 URI 是 否 为 Content URI. WR URI 未 指向 合法 的 Content 
Provider， 该 方法 返回 null。 





// If the clipboard contains a URI reference 
if (PasteUri != null) { 


// Is this a content URI? 
String uriMimeType = cr.getType(pasteUri); 


C5) 判断 Content Provider 是 否 支 持 应 用 程序 识别 的 MIME 类 型 。 若 支持 ， 则 调用 
ContentResolver.query0) 来 获取 数据 ， 返 回 值 是 一 个 Cursor 对 象 。 


// If the return value is not null, the Uri is a content Uri 
if (uriMimeType != null) ( 


// Does the content provider offer a MIME type that the current application can use? 
if (uriMimeType.equals(MIME TYPE CONTACT)) { 


// Get the data from the content provider. 
Cursor pasteCursor - cr.query(uri, null, null, null, null); 


// If the Cursor contains data, move to the first record 
if (pasteCursor !- null) ( 
if (pasteCursor.moveToFirst()) { 


// get the data from the Cursor here. The code will vary according to the 
// format of the data model. 
} 


// close the Cursor 
pasteCursor.close(); 


3. 粘贴 Intent 


要 粘贴 一 个 Intent， 首 先 获 取 全 局 剪贴 板 ， 再 检查 ClipData.Item 对 象 是 否 包含 Intent。 最 后 调 
用 getIntent0 把 Intent 复制 到 程序 的 存储 中 。 
实现 代码 如 下 : 


// Gets a handle to the Clipboard Manager 





5129 文本 与 输入 | 415 





ClipboardManager clipboard = (ClipboardManager) getSystemService (Context .CLIPBOARD SERVICE); 


// Checks to see if the clip item contains an Intent, by testing to see if getIntent() returns null 
Intent pasteIntent = clipboard.getPrimaryClip() .getItemAt (0) .getIntent (); 


if (pasteIntent != null) { 
// handle the Intent 
} else { 


// ignore the clipboard, or issue an error if your application was expecting an Intent to be 
// on the clipboard 


12.6 # Content Provider 复制 复杂 数据 


Content Provider 支持 对 复杂 数据 的 复制 ， 比 如 数据 库 记录 或 文件 流 等 。 在 复制 数据 时 ， 把 一 
个 Content URI 放 入 剪贴 板 中 ， 然 后 粘贴 应 用 程序 ， 从 剪贴 板 中 获取 该 URI， 并 用 它 读 取 数据 库 数 
据 或 者 文件 流 的 描述 符 。 

粘贴 应 用 程序 只 是 将 Content URI 作为 数据 读 取 ， 并 不 清楚 应 该 获取 数据 的 哪 部 分 ， 要 实现 其 
功能 ， 可 以 把 所 需 数据 的 ID 编 入 URI 本 身 , 或 者 让 URI 精确 返回 所 需 复制 部 分 的 数据 ， 而 采用 哪 
种 方式 取决 于 数据 的 组 织 形式 。 

1. 将 ID EA URI 编码 


利用 URI 把 数据 复制 到 剪贴 板 时 ， 可 以 把 数据 的 ID 置 入 URI 编码 本 身 ，Content Provider 得 
到 该 ID, 利用 ID 读 取 数据 。 粘贴 应 用 程序 无 须 判 断 ID 是 否 存在 , 只 需 从 剪贴 板 获 取 “ 引 用 ”(URI 
加 ID) 交 给 Content Provider， 然 后 读 取 数 据 。 

通常 的 编码 方式 是 把 ID 附 在 Content URI 后 面 。 假 设 定义 的 Provider URI 字符 串 如 下 : 


"content://com.example.contacts" 


如 果 需 要 把 名 称 置 入 URI， 使 用 如 下 代码 : 


String uriString = "content://com.example.contacts" + "/" + "Smith" 
// uriString now contains content://com.example.contacts/Smith. 


// Generates a uri object from the string representation 
Uri copyUri = Uri.parse(uriString); 

如 果 程 序 中 已 经 使 用 了 Content Provider， 只 需 新 增 一 个 指示 复制 数据 的 URI 路径。 假设 已 存 
在 以 下 URI 路 径 : 

“content: //com.example.contacts"/people 


"content: //com.example.contacts"/people/detail 


"content: //com.example.contacts"/people/images 
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下 面 加 入 一 个 用 于 复制 的 URI: 


"content: //com.example.contacts/copying” 


可 以 利用 模式 匹配 来 检测 “copy” URI， 并 用 代码 进行 复制 和 粘贴 处 理 。 
如 果 是 用 Content Provider、 内 部 数据 库 、 内 部 表 来 组 织 数 据 ， 通 常 可 以 使 用 以 上 编码 技术 。 
这 种 情况 下 会 有 多 块 数据 需要 复制 ， 很 可 能 每 块 数据 都 会 有 一 个 唯一 的 ID。 当 粘贴 应 用 程序 查询 
时 ， 可 以 用 此 ID 查找 并 返回 数据 。 如 果 没 有 多 块 数据 需要 复制 ， 就 不 必 把 ID 进行 编码 ， 简 单 地 
使 用 能 够 唯一 标识 Provider 的 URI 即 可 。 查 询 时 ，Provider 会 返回 包含 的 数据 。 

Note Pad 示例 中 就 用 ID 获取 了 单条 记录 ， 以 便 从 note 列表 中 打开 一 条 note。 此 示例 使 用 了 
SQL 数据 库 中 的 _id 字段 ， 也 可 以 根据 需要 使 用 任何 数字 或 字符 ID。 


2. 复制 数据 结构 


为 了 复制 和 粘贴 复杂 数据 ， 需 要 创建 一 个 ContentProvider 组 件 的 子 类 Content Provider， 将 编 
码 后 的 URI 放 入 剪贴 板 ， 该 URI 指向 需 提供 的 正确 记录 。 此 外 ， 还 必须 考虑 应 用 程序 的 现状 : 
© 如果 已 有 一 个 Content Provider， 只 需要 扩展 它 的 功能 ， 修 改 query0 方 法 ， 使 得 它 能 处 理 粘贴 
程序 所 需 的 URI 即 可 ， 也 可 以 修改 方法 来 对 URI 中 的 “copy” 进 行 模式 匹配 。 
© ”如 果 应 用 程序 拥有 内 部 数据 库 ， 为 了 复制 数据 ， 需 要 将 此 数据 库 移 入 Content Provider, 
© 如 果 没有 用 到 数据 库 ， 可 以 实现 一 个 简单 的 Content Provider， 其 为 程序 提供 来 自 剪 贴 板 数据 
的 粘贴 功能 。 








在 Content Provider 中 ， 需 要 重 写 query All getType0) 两 个 方法 。 
(1) query() 
假设 粘贴 应 用 程序 通过 该 方法 获取 剪贴 板 中 URI 指定 的 数据 ， 为 了 支持 复制 功能 ， 应 该 在 本 
方法 中 对 包含 指定 “copy” 路 径 的 UR 进行 检测 。 然 后 ， 程 序 可 以 创建 一 个 “copy”URI， 并 放 入 
前 贴 板 中 ， 此 URI 包含 复制 路 径 和 指向 实际 复制 记录 的 指针 。 
(2) getType() 
本 方法 返回 MIME 类 型 或 者 需 复制 数据 的 类 型 。 为 了 把 MIME 类 型 放 入 新 建 的 ClipData 对 象 
中 ，newUri0 方 法 将 会 调用 getType0 方 法 。 


insert0 或 update0 等 其 他 的 Content Provider 方法 不 需要 实现 。 粘贴 应 用 程序 只 需要 获取 所 用 


的 MIME 类 型 并 从 Provider 复制 数据 。 如 果 已 经 实现 了 这 些 方法 ， 它 们 也 不 会 影响 复制 操 
作 。 





下 面 演示 如 何 实现 复制 复杂 数据 的 应 用 程序 。 
(D 声明 全 局 常量 ， 定 义 基本 URI 字符 串 和 路 径 ， 用 于 指明 复制 数据 的 URI 字符 串 。 同 时 ， 
声明 复制 数据 的 MIME 类 型 。 


// Declares the base URI string 
private static final String CONTACTS = "content://com.example.contacts"; 


// Declares a path string for URIs that you use to copy data 
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private static final String COPY PATH = "/copy"; 


// Declares a MIME type for the copied data 
public static final String MIME TYPE CONTACT = "vnd.android.cursor.item/vnd.example.contact" 


© 在 用 户 复制 数据 的 Activity 中 ， 把 数据 复制 到 剪贴 板 ， 在 响应 复制 请 求 时 ， 将 UR 放 入 剪 
贴 板 中 的 代码 如 下 。 


public class MyCopyActivity extends Activity { 


// The user has selected a name and is requesting a copy. 
case R.id.menu_copy: 


// Appends the last name to the base URI 
// The name is stored in "lastName" 
uriString = CONTACTS + COPY PATH + "/" + lastName; 


// Parses the string into a URI 
Uri copyUri = Uri.parse(uriString); 


// Gets a handle to the clipboard service. 
ClipboardManager clipboard - (ClipboardManager) 
getSystemService (Context .CLIPBOARD_SERVICE) ; 


ClipData clip = ClipData.newUri(getContentResolver(), "URI", copyUri); 


// Set the clipboard's primary clip. 
clipboard.setPrimaryClip (clip); 


®© 在 Content Provider 的 全 局 部 分 (global scope) ， 创 建 一 个 URI 匹 配器， 并 加 入 与 前 贴 板 
URI 相 匹 配 的 URI 模式， 代码 如 下 : 


public class MyCopyProvider extends ContentProvider { 


// A Uri Match object that simplifies matching content URIs to patterns. 
private static final UriMatcher sURIMatcher - new UriMatcher(UriMatcher.NO MATCH); 


// Bn integer to use in switching based on the incoming URI pattern 
private static final int GET SINGLE CONTACT - 0; 


// Adds a matcher for the content URI. It matches 
// "content://com.example.contacts/copy/*" 
sUriMatcher.addURI(CONTACTS, "names/*", GET SINGLE CONTACT); 


© 实现 query0 方 法 。 在 本 方法 中 可 用 不 同 的 代码 处 理 各 种 URI 模式 ， 下 面 的 代码 仅 列 出 了 
剪贴 板 复制 操作 所 用 到 的 模式 。 


// Sets up your provider's query() method. 





public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, 
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String sortOrder) { 


// Switch based on the incoming content URI 
switch (sUriMatcher.match(uri)) { 


case GET_SINGLE_CONTACT: 


// query and return the contact for the requested name. Here you would decode 
// the incoming URI, query the data model based on the last name, and return the result 


// as a Cursor. 


© 实现 getType0 方 法 ， 返 回复 制 数据 的 MIME 类 型 。 


// Sets up your provider's getType() method. 
public String getType(Uri uri) { 


switch (sUriMatcher.match(uri)) { 
case GET_SINGLE_CONTACT: 


return (MIME TYPE CONTACT); 

本 部 分 描述 了 如 何 从 剪贴 板 获取 数据 的 URI， 并 通过 URI 进行 数据 的 读 取 和 粘贴 。 

3. 复制 数据 流 

大 量 的 文本 和 二 进 制 数据 可 以 以 流 的 形式 进行 复制 和 粘贴 。 这 样 的 数据 具有 如 下 特性 : 

e 保存 在 物理 设备 上 的 文件 。 

© RÁ Socket 的 流 。 

© 保存 在 Provider 底层 数据 库 系统 中 的 大 量 数据 。 

数据 流 的 Content Provider 用 诸如 AssetFileDescriptor 的 文件 描述 符 对 象 代 替 Cursor 对 象 ， 粘 
贴 应 用 程序 利用 该 文件 描述 符 来 读 取 数 据 流 。 

要 创建 Provider 复制 数据 流 的 应 用 程序 ， 遵 循 以 下 步 又: 

ED 为 放 入 剪贴 板 的 数据 流 建立 Content URI。 可 以 通过 以 下 三 种 方式 实现 。 


CD 将 数据 流 的 ID 编 入 URI， 如 上 将 ID 编 入 URI 所 述 , 然后 在 Provider 中 保存 一 张 表 ， 其 中 
包含 ID 和 相关 的 流 名 称 。 

@ 将 流 名 称 直接 编 入 URI。 

G 使 用 从 Provider 返回 到 当前 流 的 唯一 URI。 若 选用 该 方式 ， 则 每 次 通过 URI 把 流 复制 到 前 
贴 板 时 ， 必 须 更 新 Provider， 使 它 指向 新 的 流 。 

E 为 每 类 提供 的 数据 流 指定 一 个 MIME 类 型 。 粘贴 应 用 程序 需要 此 信息 来 确定 能 否 粘贴 
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剪贴 板 中 的 数据 。 

(X303 实现 ContentProvider 中 的 一 个 方法 , 返回 流 的 文件 描述 符 , 若 ID 已 编 入 Content URI, 
则 用 此 方法 来 确定 需要 打开 的 流 。 

eo 数据 复制 到 剪贴 板 时 ， 构 造 Content URI 并 放 入 剪贴 板 中 。 


粘贴 数据 流 时 ， 应 用 程序 先 从 剪贴 板 获取 clip， 读 取 URI， 然 后 调用 ContentResolver 文件 描 
述 符 方法 打开 流 。ContentResolver 方法 将 调用 相应 的 ContentProvider 方法 ， 把 Content URI 传 入 其 
中 。Provider 把 文件 描述 符 返回 给 ContentResolver 方法 ， 这 时 粘贴 程序 就 能 读 取 流 中 的 数据 了 。 

以 下 给 出 了 Content Provider 中 重要 的 文件 描述 符 方 法 。 每 个 方法 名 末端 都 增加 字符 串 
Descriptor 的 ContentResolver 方法 与 之 相对 应 。 比 如 ， 模 拟 openAssetFile() 的 ContentResolver 方法 
是 openAssetFileDescriptor() 。 

GD openTypedAssetFile() 

仅 当 给 出 的 MIME 类 型 能 被 Provider 支持 时 ， 本 方法 返回 一 个 asset 文件 描述 符 。 调 用 方 (A 
行 粘贴 的 应 用 ) 提供 MIME 类 型 模式 。 如 果 能 提供 此 类 型 MIME, Content Provider (把 URI 复制 
到 前 贴 板 的 应 用 ) 将 返回 一 个 AssetFileDescriptor 文件 句柄 ， 不 能 提供 则 抛 出 异常 。 

本 方法 用 于 处 理 文件 的 片段 ， 可 以 用 它 读 取 Content Provider 复制 到 剪贴 板 的 asset. 

Q) openAssetFile() 

本 方法 是 比 openTypedAssetFile0 更 通用 的 方法 。 它 不 对 支持 的 MIME 类 型 进行 判断 过 滤 ， 但 
可 用 于 读 取 文 件 的 片段 。 

(3) openFile() 

这 是 比 openAssetFile0 更 加 通用 的 格式 ， 但 它 不 能 读 取 文件 片段 。 

@ openPipeHelper() 

可 以 选用 openPipeHelper( 方 法 作为 文件 描述 符 方法 ， 让 粘贴 应 用 可 以 利用 管道 在 后 台 读 取 流 
数据 。 使 用 此 方法 需要 实现 ContentProvider.PipeDataWriter 接口 。 在 Note Pad 示例 程序 中 有 相关 用 
法 ， 其 使 用 位 于 NotePadProvider.java 中 的 openTypedAssetFile() 方 法 。 


12.7 ”设计 有 效 的 复制 /粘贴 功能 


要 为 应 用 程序 设计 高 效 的 复制 与 粘贴 功能 ， 需 要 注意 以 下 几 点 : 

© 任何 时 候 剪 贴 板 中 都 只 有 一 个 clip。 系 统 中 任何 应 用 程序 执行 了 新 的 复制 操作 ， 都 会 覆盖 之 
前 的 clip 。 由 于 用 户 可 能 会 跳 离 应 用 程序 ， 并 在 返回 前 执行 复制 ， 因 此 不 能 确定 剪贴 板 中 包 
含 前 一 次 在 该 程序 中 复制 的 内 容 。 

@ 设计 clip< span="">ClipData Item 对象 的 初衷 是 为 了 支持 一 次 复制 /粘贴 多 个 选项 , 而 不 是 为 了 
单个 选项 能 包含 多 种 不 同 的 格式 。 通常 一 个 clip 中 的 所 有 ClipDataItem 对 象 都 应 该 具有 相同 
的 格式 ， 也 就 是 说 ， 所 有 对 象 要 么 是 简单 文本 ， 要 么 是 Content URI AF Intent, ma HAG 
一 起 使 用 。 

o ”提供 数据 时 ,可 以 提交 各 种 不 同 的 MIME 描述 .把 所 支持 的 MIME< span="">24 ClipDescription 
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It, E Æ Content Provider 中 实现 这 些 MIME 类 型 。 

@” 从 剪贴 板 读 取 数 据 时 ， 应 用 程序 对 可 用 的 MIME 类 型 进行 检查 ， 然 后 决定 要 使 用 哪些 类 型 。 
即使 剪贴 板 中 存在 clip， 用 户 也 请 求 了 粘贴 ， 应 用 程序 不 一 定 要 执行 粘贴 ， 而 是 在 MIME 类 
型 能 够 兼容 时 才 执 行 粘贴 ， 可 以 选用 coerceToText0 把 剪贴 板 数 据 强 制 转换 成 文本 。 如 果 应 用 
程序 能 支持 多 种 MIME 类 型 ， 用 户 先 选择 其 中 一 种 使 用 。 


实例 ClipBoardDemo 修改 自 Android SDK 中 的 Demo, 演示 了 Android 的 剪贴 板 对 于 带 格式 文 
本 、 无 格式 文本 、HTML XÆ, Intent 和 URI 的 粘贴 效果 , 并 可 以 将 这 几 种 数据 格式 进行 相互 转化 。 
该 实例 的 运行 效果 如 图 12.2 所 示 。 


S! ClipBordDemo 





复制 格式 文本 Plain, bold italic, bold-italic 
复制 纯 文本 Plain, bold, italic, bold-italic 


复制 html 文 本 <b>Link:</b> «a href="http:// 


www.android.com'»Android« 


复制 intent 
复制 URI 


Data type: Text clip 


IME types: text/plain 
Data content: 
Plain, bold, italic, bold-italic 





图 12.2 ClipBoardDemo 的 运行 效果 


该 实例 的 布局 文件 clipboard.xml 的 内 容 如 下 : 


<?xml version="1.0" encoding-"utf-8"?» 
<ScrollView xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:orientation-"vertical"» 
<LinearLayout android:layout width-"match parent" 
android:layout height-"wrap content" 
android:orientation-"vertical"» 


<LinearLayout 
android: layout_width="match_ parent" 
android:layout height-"wrap content" 
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<TextView 
android: layout_width="wrap_ content" 
android:layout height-"wrap content" 
android:textAppearance-"?android:attr/textAppearanceMedium" 
android:text-"MIME types: " /» 


<TextView 
android: id="@+id/clip mime types" 
android: layout_width="0dp" 
android: layout_weight="1" 
android:layout height-"wrap content" 
android:background-"£ff303030" 
android:padding="4dp" 
android: textAppearance="?android:attr/textAppearanceMedium" 
/> 





</LinearLayout> 


<TextView 
android: layout_width=" 
android: layout_height="wrap content" 
android: layout_marginTop="4dp" 
android: textAppearance="?android:attr/textAppearanceMedium" 
android:text="Data content:" /> 





rap content" 





<TextView 





android: id="@+id/clip_text" 

android:layout width-"match parent" 

android:layout height-"wrap content" 
android:background-"$ff303030" 

android:padding-"4dp" 
android:textAppearance-"?android:attr/textAppearanceMedium" 
/» 


</LinearLayout> 
</ScrollView> 
该 实例 在 定义 Button 的 同时 直接 指定 其 响应 函数 ， 例 如 : 
<Button 
android: id="@tid/copy styled text" 





android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:onClick-"pasteStyledText" 
android:text=" 复 制 格式 文本 ” /> 


其 中 的 android:onClick="pasteStyledText" 字 段 表 示 该 按钮 被 点 击 时 ， 直 接 调用 pasteStyledTest 
方法 进行 处 理 ， 这 样 就 省 去 了 在 Java 文件 中 编写 响应 方法 的 代码 。 

该 实例 在 复制 过 程 中 用 到 了 一 个 名 为 styled_text 的 字符 串 ， 用 HTML 标识 了 文字 的 加 粗 、 斜 
体 等 效果 。 


<string name="styled text">Plain, <b>bold</b>, <i>italic</i>, 
<b><i>bold-italic</i></b></string> 


布 





局 中 


因此 ， 在 工程 的 values/strings.xml 文件 中 加 入 该 变量 名 对 应 的 字符 串 如 下 : 





的 下 拉 列 表 在 填充 数据 的 过 程 中 使 用 了 数组 进行 填充 ， 因 此 在 工程 的 values 文件 夹 下 
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新 建 Arrays.xml 文件 ， 并 新 建 数组 数据 如 下 : 


<?xml version-"1.0" encoding-"utf-8"?» 
«resources» 








<string-array name-"clip data types"» 


<item>No data in clipboard</item> 
<item>Text clip</item> 

<item>HTML Text clip</item> 
<item>Intent clip</item> 
<item>Uri clip</item> 
<item>Coerce to text</item> 
<item>Coerce to styled text</item> 
<item>Coerce to HTML text</item> 


</string-array> 
</resources> 


实例 ClipBoardDemo 的 MainActivity.java 文件 代码 如 下 : 


package introduction.android.clipboard; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


public 


android.app.Activity; 
android.content.ClipboardManager; 
android.content.ClipData; 
android.content.Context; 
android.content.Intent; 
android.content.res.Resources; 
android.net.Uri; 

android.os.Bundle; 
android.text.method.LinkMovementMethod; 
android.view.View; 
android.widget.AdapterView; 
android.widget.ArrayAdapter; 
android.widget.Spinner; 
android.widget.TextView; 
android.widget.AdapterView.OnItemSelectedListener; 


class MainActivity extends Activity ( 


ClipboardManager mClipboard; 


Spinner mSpinner; 
TextView mMimeTypes; 
TextView mDataText; 


CharSequence mStyledText; 
String mPlainText; 

String mHtmlText; 

String mHtmlPlainText; 


ClipboardManager.OnPrimaryClipChangedListener mPrimaryChangeListener 


ClipboardManager.OnPrimaryClipChangedListener() { 


public void onPrimaryClipChanged() { 
updateClipData (true); 


new 
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@override 
protected void onCreate(Bundle savedInstanceState) { 
super. onCreate (savedInstanceState) ; 


mClipboard = (ClipboardManager) getSystemService (CLIPBOARD SERVICE); 
setContentView (R. layout .clipboard) ; 
TextView tv; 


mStyledText = getText (R.string.styled text); 
tv = (TextView) findViewById(R.id.styled text); 
tv.setText (mStyledText); 


mPlainText = mStyledText.toString(); 
tv = (TextView) findViewById(R.id.plain text); 
tv.setText (mPlainText); 


mHtmlText = "<b>Link:</b> «a href=\"http://www.android.com\">Android</a>"; 
mHtmlPlainText = "Link: http://www.android.com"; 

tv = (TextView) findViewById(R.id.html text); 

tv.setText (mHtmlText); 


mSpinner - (Spinner) findViewById(R.id.clip type); 
ArrayAdapter«CharSequence» adapter = ArrayAdapter.createFromResource (this, 
R.array.clip data types, 
android.R.layout.simple spinner item); 
adapter.setDropDownViewResource (android.R.layout.simple spinner dropdown item); 
mSpinner.setAdapter (adapter); 
mSpinner.setOnItemSelectedListener(new OnItemSelectedListener() ( 
public void onItemSelected (AdapterView<?> parent, View view, int position, long 
id) ( 
updateClipData (false); 


public void onNothingSelected(AdapterView<?> parent) { 
$ 
ns 


mMimeTypes = (TextView) findViewById(R.id.clip mime types); 
mDataText = (TextView) findViewById(R.id.clip text); 


mClipboard.addPrimaryClipChangedListener (mPrimaryChangeListener); 
updateClipData (true); 


@Override 
protected void onDestroy() { 
super.onDestroy():; 
mClipboard.removePrimaryClipChangedListener (mPrimaryChangeListener); 


public void pasteStyledText (View button) ( 
mClipboard. setPrimaryClip (ClipData.newPlainText ("Styled Text", mStyledText) ); 


426 | Android 7 应 用 程序 开发 教程 





第 12 章 文本 与 输入 | 427 





428 | Android 7 应 用 程序 开发 教程 





} else { 
mSpinner.setSelection (0); 


y 


是 根据 粘贴 内 容 来 确定 下 拉 列 表 的 显示 项 的 。 
代码 段 : 


ClipData.Item item = clip.getItemAt (0); 
switch (mSpinner.getSelectedItemPosition()) { 
case 0: 
mDataText.setText (" (No data)"); 
break; 
case 1: 
mDataText.setText (item.getText ()); 
break; 
case 2: 
mDataText.setText (item.getHtmlText ()); 
break; 
case 3: 
mDataText.setText (item.getIntent () .toUri (0)); 
break? 
case 4: 
mDataText.setText (item.getUri ().toString()); 
break; 
case 5: 
mDataText.setText (item.coerceToText (this)); 
break; 
case 6: 
mDataText.setText (item.coerceToStyledText (this)); 
break; 
case 7: 
mDataText.setText (item.coerceToHtmlText (this)); 
break; 
default: 
mDataText.setText ("Unknown option: " + 
mSpinner.getSelectedItemPosition()); 
break; 


) 
是 根据 用 户 选 择 的 下 拉 列 表 项 将 粘贴 内 容 转化 为 相应 字符 串 并 显示 出 来 的 。 


129 小 & 





本 章 主要 介绍 了 Android 7.0 提供 的 文本 输入 和 粘贴 服务 ， 对 剪贴 板 服务 框架 和 剪贴 板 类 进行 
了 介绍 ， 并 详细 介绍 了 将 数据 复制 到 剪贴 板 和 从 剪贴 板 获取 数据 的 方法 ， 以 及 从 Content Provider 
中 获取 数据 的 方法 。 

通过 系统 提供 的 剪贴 板 可 以 轻松 实现 对 纯 文 本 、 格 式 文 本 、HTML 文本 、Intent 和 URI 的 复制 
和 粘贴 ， 并 且 可 以 实现 这 几 种 格式 的 文本 之 间 的 字符 串 转 化 。 本 章 最 后 通过 实例 演示 了 这 些 功能 。 


13.1 设备 管理 AP| 概述 


如 果 Android 设备 的 某 个 硬件 出 现 故 障 ，Android 设备 会 提示 用 户 相 关 信息 ; 如 果 丢 了 与 自己 
的 Google 账户 相关 联 的 Android 设备 ， 也 可 以 帮 你 找到 、 锁 定 并 清空 该 设备 。 这 些 功能 都 是 依靠 
Android 设备 管理 实现 的 。 

其 实 ，Android 从 2.2 版 本 开始 就 提供 了 一 套 设备 管理 API 来 进行 Android 设备 的 管理 工作 ， 
其 中 包含 设备 锁 屏 、 禁 用 启用 摄像 头 (4.0 开始 提供 )、 擦 除 用 户 数据 等 一 系列 设备 管理 策略 。 这 些 
API 在 安全 设置 中 都 是 非常 有 用 的 。 例 如 ，Android 内 置 的 电子 邮件 充分 利用 了 新 的 API， 以 提高 
Exchange 的 支持 ， 通 过 电子 邮件 应 用 程序 ， 管 理 员 借助 Exchange 可 以 强制 执行 跨 设备 密码 策略 ， 
包括 字母 数字 密码 或 数字 的 PIN。 管 理 员 还 可 以 远程 控 除 〈 恢 复出 三 设置 ) 丢失 或 被 盗 的 手机 。 
Exchange 用 户 可 以 同步 自己 的 电子 邮件 、 日 历数 据 等 。 

使 用 设备 管理 常见 的 应 用 有 电子 邮件 客户 端 、 远 程 数 据 擦 除 、 设 备 管理 服务 等 。 

本 章 主 要 介绍 Android 设备 管理 的 工作 过 程 、 管 理 策 略 及 开发 设备 管理 应 用 的 过 程 。 





13.1.1 设备 管理 工作 过 程 


可 以 使 用 设备 管理 API 来 编写 设备 管理 应 用 、 用 户 对 设备 的 安装 以 及 设备 管理 应 用 执行 所 需 
的 策略 。 

设备 管理 的 工作 过 程 分 为 以 下 4 个 步骤 : 

ED 系统 管理 员 写 入 一 个 设备 管理 应 用 , 执行 远程 /本 地 设备 安全 策略 。 这 些 策略 以 硬 编码 
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的 形式 进入 应 用 ， 或 者 可 以 从 第 三 方 服务 器 上 动态 获取 。 

Eo 在 用 户 的 设备 上 安装 应 用 程序 。 安 卓 目前 还 没有 一 个 自动 配置 的 解决 方案 , 但 可 以 采 
用 如 下 方式 将 应 用 程序 分 发 到 用 户 设备 。 

e 谷歌 商店 。 

e 从 其 他 存储 上 启用 安装 。 

@ ”通过 其 他 手段 分 配 应 用 ， 比 如 电子 邮件 或 者 网 站 。 


CX303 系统 将 提示 用 户 使 用 设备 管理 应 用 程序 。 这 种 情况 取决 于 应 用 程序 是 如 何 实现 的 。 
CMs 一 旦 用 户 允 许 设备 来 管理 应 用 程序 ， 他 们 就 要 遵守 其 规定 ， 除 了 被 约束 外 ， 遵 守 规 定 
也 是 有 好 处 的 ， 如 可 以 访问 敏感 系统 和 数据 。 


即使 用 户 没有 开启 设备 管理 应 用 ， 但 在 设备 上 它 仍 然 存 在 ， 只 不 过 处 于 非 活动 状态 。 当 然 ， 
用 户 不 会 被 它 管理 ， 也 不 会 被 任何 应 用 程序 管理 。 例 如 ， 用 户 可 能 无 法 同步 数据 。 

如 果 一 个 用 户 不 遵守 规定 《〈 比 如 用 户 设置 的 密码 违反 规则 ) ， 它 将 由 应 用 程序 处 理 。 然 而 ， 
通常 会 导致 用 户 无 法 同步 数据 。 

如 果 一 个 设备 试图 连接 到 服务 器 ， 但 请 求 设备 管理 API 不 支持 其 规定 ， 则 不 允许 连接 。 设 备 
管理 API 当前 不 允许 部 分 配置 ， 换 句 话说 ， 如 果 一 个 设备 (如 一 个 遗留 的 设备 ) 不 支持 所 有 规定 ， 
那么 没 办 法 连接 设备 。 

如 果 一 个 设备 包含 多 种 功能 的 管理 应 用 ， 它 们 会 按照 严格 的 策略 进行 管理 ， 而 不 存在 特殊 情 
况 。 如 果 要 卸载 一 个 设备 管理 应 用 程序 ， 用 户 可 以 管理 员 身份 先 注销 该 应 用 程序 。 





13.1.2 设备 管理 策略 


在 企业 级 应 用 的 设置 中 ， 设 备 管理 API 依据 一 套 必 须 严 格 遵守 的 规范 来 管理 设备 。 设 备 管理 

API 支 持 的 规范 如 表 13.1 所 示 ， 需 要 注意 的 是 ， 设 备 管理 API 目前 只 支持 密码 锁 屏 。 
表 13.1 设备 管理 API 支持 的 策略 

说 明 
Password enabled 设备 询问 pin 或 者 密码 的 请 求 
Minimum password length 设置 密码 字符 需要 的 数目 。 比 如 ， 可 以 请 求 最 少 6 位 
最 小 密码 长 度 字符 的 pin 或 者 密码 
Alphanumeric password required 由 数字 和 字母 组 成 的 密码 请 求 ， 可 能 包括 符号 字符 
字母 数字 密码 请 求 
Complex password required 密码 必须 包含 至 少 一 个 字母 、 一 个 数字 和 一 个 特殊 符 
复杂 密码 请 求 号 ， 参 看 3.0 
Minimum letters required in password 所 有 管理 权限 或 者 特殊 部 分 密码 请 求 的 最 小 字母 数 ， 
密码 最 小 字母 请 求 参看 3.0 
Minimum lowercase letters required in password 所 有 管理 权限 或 者 特殊 部 分 密码 请 求 的 最 小 小 写字 母 
密码 中 的 最 小 小 写字 母 请 求 数 ， 参 看 3.0 
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( 续 表 ) 





策略 


说 明 





Minimum non-letter characters required in password 
密码 中 的 最 小 非 字母 型 字符 请 求 


所 有 管理 权限 或 特殊 部 分 密码 中 ， 请 求 的 非 字母 型 字 
符 的 最 小 数 ， 参 看 3.0 





Minimum numerical digits required in password 
密码 中 最 小 数字 请 求 


所 有 管理 权限 或 特殊 部 分 的 密码 中 ， 请 求 的 数字 字符 
的 最 小 数 ， 参 看 3.0 





Minimum symbols required in password 


所 有 管理 权限 和 特殊 部 分 的 密码 中 ， 请 求 的 符号 的 最 





密码 需求 的 最 小 符号 小 数 ， 参 看 3.0 
Minimum uppercase letters required in password 所 有 管理 权限 和 特殊 部 分 的 密码 中 ， 请 求 的 大 写字 母 
密码 的 最 小 大 写字 母 需求 的 最 小 数 ， 参 看 3.0 


Password expiration timeout 
密码 过 期 超时 间 题 





当 设 备 管理 设置 过 期 超时 时 ， 一 个 即将 过 期 的 密码 表 
现 为 毫秒 中 的 变量 增 量 ， 参 看 3.0 





了 Password history restriction 
密码 历史 限制 


Maximum failed password attempts 
最 大 密码 尝试 失败 


Maximum inactivity time lock 
最 大 闲置 时 间 锁 定 


Require storage encryption 
存储 加 密 需 求 
Disable camera 


禁用 相机 




















防止 用 户 重用 过 去 的 n 唯一 密码 。 结 合 
setPasswordExpirationTimeout () 使 用 ,使 用 
户 定期 更 新 密码 ， 参 看 3.0 

在 设备 擦拭 数据 之 前 指定 用 户 输入 错误 的 密码 次 数 。 
设备 管理 APL 也 允许 管理 员 远 程 重 置 设备 (默认 出 厂 
设置 )， 可 以 在 设备 丢失 或 者 被 盗 之 后 保证 数据 安全 
设置 用 户 最 后 触摸 屏幕 或 者 按键 后 锁 屏 的 时 间 。 当 触 
发 后 ， 再 次 使 用 设备 并 访问 数据 之 前 ， 用 户 需 要 再 次 
输入 pin 或 者 密码 ， 值 在 1~60 分 

如 果 设 备 支持 ， 指 定 应 该 加 密 的 存储 范围 ， 参 看 3.0 


指定 应 该 禁用 的 相机 (并 非 永久 性 的 禁用 )， 相 机 可 以 
基于 语 境 、 时 间 等 来 动态 开启 /禁用 ， 参 看 4.0 





依据 表 13.1 的 策略 ， 设 备 管理 API 可 以 实现 诸多 功能 ， 例 如 : 


e ”提示 用 户 设置 新 密码 。 
e 立刻 锁 住 设备 。 


o ”擦拭 设备 数据 ( 恢复 设备 到 其 出 厂 默认 设置 )。 
为 了 更 好 地 理解 和 实现 设备 管理 ， 这 里 我 们 通过 一 个 案例 进行 介绍 。 





13.2 ”开发 设备 管理 API 应 用 


本 节 通 过 SDK 中 的 一 个 实例 来 讲解 设备 管理 API 的 使 用 方法 ， 运 行 效果 如 图 13.1 所 示 。 
该 范例 程序 提供 了 一 个 使 用 设备 管理 API 进行 设备 管理 的 模板 ， 它 展示 了 设备 管理 API 的 用 


户 交互 方法 。 其 功能 如 下 : 
e 设置 密码 级 别 。 
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e 用 户 密码 的 特殊 需求 。 比 如 ， 最 小 的 密码 长 度 ， 密 码 中 必须 包含 数字 、 字 符 型 数据 的 最 小 数 
量 等 。 

© 设置 密码 。 如 果 密 码 不 符合 指定 的 策略 ， 系 统 返回 一 个 错误 。 

© ”设置 错误 密码 的 尝试 次 数 ， 可 以 在 设备 删除 之 前 出 现 (恢复 到 出 厂 设置 )。 

e 设置 密码 将 要 过 期 的 时 间 长 度 。 

e 设置 密码 历史 长 度 (长 度 是 关于 旧 密 码 保存 的 历史 数量 )。 提供 用户 重新 使 用 之 前 使 用 过 的 最 
后 了 个 密码 中 的 一 个 。 

o ”如 果 设 备 支 持 ， 指 定 应 该 被 加 密 的 存储 数据 。 

e 设置 闲置 时 间 的 最 大 值 ， 即 在 设备 自动 锁定 前 的 等 待 时 间 。 

e 使 设备 立刻 锁 住 。 

o ”擦拭 设备 数据 (恢复 出 厂 设置 )。 

e Mah, 





图 13.1 Bee 











系统 管理 员 可 以 使 用 设备 管理 API 来 编写 一 个 应 用 ， 强 制 执行 远程 /本 地 设备 安全 政策 。 这 部 
分 给 出 了 创建 一 个 设备 管理 应 用 的 实现 步 又 。 








13.2.1 创建 程序 代码 


对 于 使 用 设备 管理 API 的 应 用 程序 ， 其 AndroidManifest.xml 代码 必须 包含 如 下 信息 。 
(1) DeviceAdminReceiver 的 一 个 子 类 ， 包 括 : 
e BIND DEVICE ADMIN 权限 。 
e 响应 ACTION DEVICE ADMIN ENABLED ##! Intent 的 能 力 ， 在 声明 中 作为 一 个 Intent 
Filter 表达 。 
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(2) 元 数据 中 使 用 的 安全 政策 的 声明 。 
设备 管理 范例 程序 的 AndroidManifest xml 代码 如 下 : 
«activity android:name-".app.DeviceAdminSample" 
android: label="@string/activity sample device admin"» 
<intent-filter> 
<action android:name-"android.intent.action.MAIN" /> 
<category android:name="android.intent.category.SAMPLE CODE" /> 
</intent-filter> 
</activity> 
<receiver android:name-".app.DeviceAdminSample$DeviceAdminSampleReceiver" 
android: label="@string/sample_device_admin” 
android:description="@string/sample device admin description" 
android:permission-"android.permission.BIND DEVICE ADMIN"» 
<meta-data android:name-"android.app.device admin" 
android:resource-"Gxml/device admin sample" /> 
<intent-filter> 
<action android:name="android.app.action.DEVICE ADMIN ENABLED" /> 
</intent-filter> 
</receiver> 


注意 : 
(1) 在 项 目的 ApiDemos/res/values/strings.xml 中 设置 以 下 属性 值 。 
* android:label="@string/activity_sample device admin" 用 户 可 读 库 。 
* android:label-"(string/sample device admin" 用 户 可 读 库 的 权限 。 
* android:description-"(string/sample device admin description" 用 户 可 读 的 权限 描述 , 一 个 描 
述 通常 是 更 长 和 更 丰富 的 内 容 。 


关于 更 多 资源 的 相关 信息 ， 请 参看 Application Resources。 

(2) android:permission-"android.permission.BIND DEVICE ADMIN" 是 DeviceAdminReceiver 
子 类 具备 的 权限 ， 保 证 系统 的 应 用 权限 (其 他 应 用 都 不 会 拥有 该 权限 ) ， 对 滥用 设备 管理 的 其 他 应 
用 提供 防御 。 

(3) android:name="android.app.action.DEVICE ADMIN ENABLED" 是 DeviceAdminReceiver 
的 子 类 的 Action 类 型 ， 用 于 对 设备 进行 管理 。 当 用 户 开启 设备 管理 应 用 时 ， 它 被 设置 为 接收 者 。 
代码 通常 在 onEnabled0 中 处 理 。 为 了 得 到 支持 ， 接 收 者 也 必须 得 到 BIND DEVICE ADMIN 权限 
以 便 其 他 应 用 程序 无 法 拒绝 。 

(4) 当 用 户 开启 设 备 管理 应 用 时 ,给 接收 者 权限 去 执行 ,回应 给 系统 特定 的 接收 事件 的 广播 。 
当 出 现 匹配 的 事件 时 ， 应 用 就 可 以 强加 一 个 规范 。 比 如 ， 如 果 用 户 尝试 设置 一 个 新 的 但 不 符合 规范 
的 密码 ， 应 用 可 以 提示 用 户 选 择 一 个 不 同 的 符合 规范 的 密码 。 

(5) android:resource="@xml/device_ admin sample" 声明 使 用 在 元 数据 中 的 安全 规范 。 元 数据 
为 指定 设备 管理 员 提供 了 更 多 被 DeviceAdminInfo 类 所 解析 的 信息 。 

以 下 是 device admin sample.xml 的 代码 。 
<device-admin xmlns:android="http: //schemas.android.com/apk/res/android"> 
<uses-policies> 


<limit-password /> 
<watch-login /> 
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<reset-password /> 
<force-lock /> 
<wipe-data /> 
<expire-password /> 
<encrypted-storage /> 
<disable-camera /> 
</uses-policies> 
</device-admin> 
在 设备 管理 应 用 设计 中 ， 不 需要 包括 所 有 的 策略 ， 只 要 有 和 应 用 相关 的 策略 就 可 以 。 
设备 管理 API 包含 以 下 几 个 类 。 
(1) DeviceAdminReceiver 
该 类 是 完成 设备 管理 组 件 的 基 类 。 这 个 类 提供 了 一 个 解释 系统 发 送 的 原始 Intent 动作 的 方便 途 
径 。 设 备 管理 程序 必须 包含 一 个 它 的 子 类 。 
(2) DevicePolicyManager 
该 类 负责 管理 在 设备 上 执行 的 安全 策略 。 大 多 数 客户 端 要 发 布 一 个 已 经 被 当前 用 户 启 用 的 
DeviceAdminReceiver。DevicePolicyManager 为 至 少 一 个 DeviceAdminReceiver 实例 管理 安全 策略 。 
(3) DeviceAdminInfo 
该 类 是 用 来 为 系统 管理 组 件 指定 元 数据 的 。 
这 些 类 提供 一 个 设备 管理 应 用 实现 的 基础 。 接 下 来 将 描述 如 何 使 用 DeviceAdminReceiver 和 
DevicePolicyManager API 来 编写 一 个 设备 管理 应 用 。 





13.2.2 DeviceAdminReceiver 的 子 类 


要 创建 一 个 设备 管理 应 用 程序 ， 必 须 实现 一 个 DeviceAdminReceiver 的 子 类 。 
DeviceAdminReceiver 包含 一 系列 回调 函数 ， 这 些 回调 函数 会 在 具体 的 事件 发 生 时 被 调用 。 
以 下 代码 只 在 DeviceAdminReceiver 子 类 中 简单 地 显示 了 Toast， 作 为 对 相应 事件 的 应 答 。 


public class DeviceAdminSample extends DeviceAdminReceiver { 





void showToast (Context context, String msg) { 
String status = context.getString(R.string.admin receiver status, msg); 
Toast.makeText(context, status, Toast.LENGTH SHORT).show(); 

} 


@Override 
public void onEnabled (Context context, Intent intent) { 

showToast (context, context.getString(R.string.admin receiver status enabled)); 
y 


GOverride 

public CharSequence onDisableRequested(Context context, Intent intent) { 
return context.getString(R.string.admin receiver status disable warning); 

y 


GOverride 
public void onDisabled(Context context, Intent intent) { 
showToast (context, context.getString(R.string.admin receiver status disabled)); 
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5 


@override 
public void onPasswordChanged (Context context, Intent 


intent) { 


showToast (context, context.getString(R.string.admin_receiver_status_pw_changed)); 


5 


1323 BREF 





用 户 启用 程序 是 设备 管理 程序 要 处 理 的 最 重要 的 事件 之 一 。 用 户 必须 明确 启用 设备 管理 程序 
才能 使 安全 策略 在 设备 上 得 以 执行 。 如 果 用 户 选 择 不 启用 ,那么 安全 策略 就 不 会 被 执行 , 用 户 也 就 


























无 法 使 用 设备 管理 程序 。 








只 要 用 户 发 出 了 ACTION ADD DEVICE ADMIN 的 Intent 动作 , 应 用 程序 即 可 被 启用 。 在 以 
下 示例 中 ， 用 户 点 击 “Enable Admin” 选择 框 ， 设 备 就 会 提示 用 户 已 经 启用 了 设备 管理 程序 ， 如 




















图 13.2 所 示 。 


ro Sample Device Admin 


Erase all data 
E 1 
Changethe screen-unlock password 
Set password rules 
t 


Monitor screen-unlock attempts 
Monitor tH ds enter 
ck 


Lock the screen 


Set lock-screen password expiration 
Set storage encryption 
Disable cameras 

Cancel 


图 13.2 启用 程序 








回调 函数 。 当 用 户 改变 Preference 的 值 时 ， 就 会 调用 这 个 回 




















Activate 


` 面 是 当 用 户 点 击 “Enable Admin ”选择 框 时 要 执行 的 代码 , 结果 触发 了 onPreferenceChange() 


调 函 数 。 如 果 用 户 启用 程序 ， 界 面 就 会 





提示 用 户 正在 启用 程序 ， 如 图 13.2 所 示 ， 否 则 就 是 禁止 程序 。 
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@Override 
public boolean onPreferenceChange (Preference preference, Object newValue) { 
if (super.onPreferenceChange (preference, newValue)) { 
return true; 

) 

boolean value - (Boolean) newValue; 

if (preference == mEnableCheckbox) { 

if (value != mAdminActive) { 
if (value) ( 
// Launch the activity to have the user enable our admin. 
Intent intent = new Intent (DevicePolicyManager.ACTION ADD DEVICE ADMIN); 
intent.putExtra (DevicePolicyManager.EXTRA DEVICE ADMIN, 
mDeviceAdminSample); 
intent.putExtra (DevicePolicyManager.EXTRA ADD EXPLANATION, 
mActivity.getString(R.string.add admin extra app text)); 
startActivityForResult(intent, REQUEST CODE ENABLE ADMIN); 
// return false - don't update checkbox until we're really active 
return false; 
} else { 

mDPM. removeActiveAdmin (mDeviceAdminSample) ; 
enableDeviceCapabilitiesArea (false) ; 
mAdminActive = false; 


) 
) else if (preference == mDisableCameraCheckbox) { 
mDPM. setCameraDisabled (mDeviceAdminSample, value); 


} 
return true; 


其 中 ，intent.putExtra(DevicePolicyManagerEXTRA_DEVICE ADMIN, mDeviceAdminSample) 
说 明 mDeviceAdminSample 是 目标 策略 (DeviceAdminReceiver 是 一 个 组 件 ) 。 这 些 代码 会 调用 图 
13.2 的 界面 ， 让 用 户 选择 是 否 添加 系统 管理 员 。 

使 用 DevicePolicyManager 的 isAdminActive() 方 法 可 以 实现 确定 管理 程序 是 否 已 经 被 启用 。 需 
要 注意 的 是 ， 该 方法 需要 一 个 DeviceAdminReceiver 类 型 的 参数 。 


DevicePolicyManager mDPM; 





private boolean isActiveAdmin() { 
return mDPM. isAdminActive (mDeviceAdminSample); 


13.24 “管理 策略 


DevicePolicyManager 是 设备 管理 的 主 类 。 通 过 它 可 以 实现 屏幕 锁定 、 屏 幕 亮度 调节 、 出 厂 设 
置 等 功能 。 DevicePolicyManager 为 一 个 或 多 个 DeviceAdminReceiver 类 的 实例 管理 策略 。 
获得 DevicePolicyManager 实例 的 方法 可 以 通过 以 下 代码 实现 : 


DevicePolicyManager mDPM = 
(DevicePolicyManager) getSystemService (Context .DEVICE_POLICY_SERVICE) ; 
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本 小 节 主要 描述 如 何 使 用 DevicePolicyManager 执行 设置 密码 策略 、 设 备 解锁 策略 和 指定 数据 
擦 除 功 能 等 。 


(1) 设置 密码 策略 


DevicePolicyManager 包括 许多 用 来 设置 和 执行 设备 密码 策略 的 API。 在 设备 管理 API 中 ， 密 
码 只 是 用 来 解锁 屏幕 的 。 本 小 节 描述 了 密码 相关 的 任务 。 


(2) 设置 设备 密码 


以 下 代码 用 于 显示 一 个 用 户 界面 提醒 用 户 设置 密码 : 


Intent intent = new Intent (DevicePolicyManager.ACTION SET NEW PASSWORD); 
startActivity (intent); 


(3) 设置 密码 组 成 策略 


解锁 策略 可 以 由 DevicePolicyManager 的 常量 来 设置 。 


PASSWORD QUALITY ALPHABETIC 用 户 输 入 的 密码 必须 要 有 字母 (或 者 其 他 字符 )。 
PASSWORD QUALITY ALPHANUMERIC 用 户 输入 的 密码 必须 要 有 字母 和 数字 。 
PASSWORD QUALITY NUMERIC 用 户 输入 的 密码 必须 要 有 数字 。 

PASSWORD QUALITY COMPLEX 用户 输入 的 密码 必须 要 有 至 少 一 个 数字 、 字 母 和 特殊 
字符 。 

PASSWORD QUALITY SOMETHING 由 设计 人 员 决 定 。 

PASSWORD QUALITY UNSPECIFIED 对 密码 没有 要 求 。 


例如 ， 按 需求 设置 数字 密码 ， 其 设置 策略 如 下 : 


DevicePolicyManager mDPM; 
ComponentName mDeviceAdminSample; 


mDPM. setPasswordQuality (mDeviceAdminSample, DevicePolicyManager.PASSWORD_QUALITY_ALPHANUMERIC) ; 


(4) 设置 对 密码 内 容 的 具体 要 求 


从 Android 3.0 开始 , DevicePolicyManager 就 提供 了 一 些 能 很 好 地 调节 密码 内 容 的 方法 。 例 如 ， 
可 以 要 求 密码 必须 有 n 个 大 写字 母 。 下 面 这 些 就 是 提供 功能 的 方法 : 


setPasswordMinimumL etters() 
setPasswordMinimumLowerCase() 
setPasswordMinimumUpperCase() 
setPasswordMinimumNonL etter() 
setPasswordMinimumNumeric() 
setPasswordMinimumSymbols() 


设置 最 少 两 个 大 写字 母 的 密码 ， 其 代码 如 下 : 


DevicePolicyManager mDPM; 


ComponentName mDeviceAdminSample; 


int pwMinUppercase = 2; 


mDPM. si 


et PasswordMinimumUpperCase (mDeviceAdminSample, pwMinUppercase) ; 
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(5) 设置 密码 最 小 长 度 
可 以 指定 密码 的 最 小 长 度 ， 例 如 : 


DevicePolicyManager mDPM; 
ComponentName mDeviceAdminSample; 
int pwLength; 


mDPM.setPasswordMinimumLength (mDeviceAdminSample, pwLength); 


(6) 设置 密码 最 多 错误 输入 次 数 
可 以 设置 允许 密码 输入 错误 的 最 大 次 数 ， 超 过 这 个 次 数 设 备 就 要 擦 除数 据 ( 恢 复出 厂 设置 )， 
例如 : 


DevicePolicyManager mDPM; 
ComponentName mDeviceAdminSample; 
int maxFailedPw; 


mDPM.setMaximumFailedPasswordsForWipe (mDeviceAdminSample, maxFailedPw); 


(7) 设置 密码 过 期 时 间 

从 Android 3.0 开始 ， 可 以 使 用 setPasswordExpirationTimeout() 方 法 设置 密码 何 时 失效 ， 系 统 
会 以 毫秒 为 单位 倒计时 ， 例 如 : 

DevicePolicyManager mDPM; 


ComponentName mDeviceAdminSample; 
long pwExpiration; 


mDPM. setPasswordExpirationTimeout (mDeviceAdminSample, pwExpiration) ; 


C8) 对 密码 的 历史 记录 进行 限制 

从 Android 3.0 开始 ， 可 以 使 用 setPasswordHistoryLengthO 〇 限制 用 户 使 用 的 密码 要 多 久 不 能 重 
E, 这 个 方法 中 包含 length 参数 ， 该 参数 用 来 设置 要 记录 密码 的 个 数 。 当 该 策略 被 激活 时 ， 用 户 就 
不 能 使 用 所 设 定 范围 内 的 旧 密 码 当 作 新 密码 使 用 , 防止 用 户 一 直 使 用 同一 个 密码 。 这 个 策略 通常 与 
setPasswordExpirationTimeout(0 一 起 使 用 ， 和 迫使 用 户 每 过 一 段 时 间 就 得 换 一 个 新 的 密码 。 

例如 ， 下 面 的 代码 可 以 防止 用 户 使 用 近期 用 过 的 5 个 密码 : 


DevicePolicyManager mDPM; 
ComponentName mDeviceAdminSample; 
int pwHistoryLength = 5; 


Lo setPasswordHistoryLength (mDeviceAdminSample, pwHistoryLength); 
(9) 设置 锁 屏 
在 设 定 的 时 间 内 没有 使 用 设备 ， 就 把 设备 锁 屏 ， 例 如 : 
DevicePolicyManager mDPM; 


ComponentName mDeviceAdminSample; 


long timeMs = 1000L*Long.parseLong (mTimeout.getText () .toString()); 
mDPM.setMaximumTimeToLock(mDeviceAdminSample, timeMs); 


还 可 以 使 设备 立即 锁 屏 : 
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DevicePolicyManager mDPM; 
mDPM.lockNow(); 


(10) 数据 擦 除 

可 以 使 用 DevicePolicyManager 的 wipeData0 方 法 使 设备 恢复 出 厂 设置 。 在 设备 被 偷 或 者 丢失 
的 情况 下 非常 用。 当然 ， 恢 复出 厂 设置 要 慎 用 。 例 如 ， 在 用 户 输 入 错误 密码 达到 固定 次 数 之 后 ， 
可 以 使 用 setMaximumFailedPasswordsForWipe() 来 擦 除 设备 数据 ， 代 码 如 下 : 


DevicePolicyManager mDPM; 
mDPM.wipeData (0) ; 


wipeData0 方 法 的 参数 是 一 个 整数 ， 这 里 暂时 必须 为 0。 

(OD 禁用 摄像 头 

Android N 系统 可 以 禁用 摄像 头 , 但 不 是 永久 禁用 。 摄像头 可 以 动态 地 禁用 /启用 在 不 同 的 上 下 
文 、 时 间 等 。 

使 用 setCameraDisabled0) 来 设置 摄像 头 是 否 被 禁用 。 例 如 ， 下 面 的 代码 就 根据 选择 框 的 状态 来 
决定 摄像 头 是 否 被 禁用 : 

Private CheckBoxPreference mDisableCameraCheckbox; 


DevicePolicyManager mDPM; 
ComponentName mDeviceAdminSample; 














mDPM. setCameraDisabled (mDeviceAdminSample, mDisableCameraCheckbox.isChecked ()) + 


(12) 加 密 存储 
从 Android 3.0 开始 , 可 以 使 用 setStorageEncryption0 方 法 来 设置 加 密 存储 , 前 提 是 设备 必须 支 
持 ， 例 如 : 
DevicePolicyManager mDPM; 


ComponentName mDeviceAdminSample; 


mDPM.setStorageEncryption (mDeviceAdminSample, true); 


13.8 AEE API 


Android 7.0 提供 了 TextToSpeech API， 可 以 方便 地 实现 将 文本 转化 为 语音 的 功能 。 借 助 于 
TextToSpeech API， 企 业 可 以 很 容易 地 开发 出 自己 的 基于 文本 的 语音 播放 应 用 程序 。 

TextToSpeechDemo 是 一 个 使 用 TextToSpeech API 进行 文本 语音 播放 的 实例 ， 修 改 自 Android 
SDK 自 带 的 Demo 实例 ， 其 运行 效果 如 图 13.3 所 示 。 点 击 speak 按钮 就 可 以 将 按钮 下 方 显示 的 文 
本 内 容 以 语音 方式 播放 出 来 。 
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$! TextToSpeechActivity 





speak 


| am a good student! 





图 13.3 文本 语音 播放 


其 布局 文件 text to speech.xml 的 内 容 如 下 : 


<?xml version-"1.0" encoding="utf-8"?> 


<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"match parent" 
android:layout height-"match parent" 








> 

<Button 
android: id="@+id/again_button” 
android:layout width-"wrap content" 
android:layout height rap content" 
android:enabled-"false" 
android:text-"speak" /» 

<TextView 
android: id="@+id/textView1" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Large Text" 
android:textAppearance-"?android:attr/textAppearanceLarge" /» 

</LinearLayout> 





|| TextToSpeechDemo 中 TextToSpeechActivity java 的 代码 如 下 : 


package introduction.Android.text; 


import 
import 
import 
import 
import 
import 
import 
import 


import 


public 


java.util.Locale; 
java.util.Random; 
android.app.Activity; 
android.os.Bundle; 
android.speech.tts.TextToSpeech; 
android.util.Log; 
android.view.View; 
android.widget.Button; 


android.widget.TextView; 


class TextToSpeechActivity extends Activity implements TextToSpeech.OnInitListener { 


private static final String TAG = "TextToSpeechDemo"; 
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private TextToSpeech mTts; 
private Button mAgainButton; 
private TextView tv; 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.text to speech); 


// Initialize text-to-speech. This is an asynchronous operation. 


// The OnInitListener (second argument) is called after initialization completes. 


mTts = new TextToSpeech (this, 
this // TextToSpeech.OnInitListener 
NG 
tv-(TextView) this.findViewById(R.id.textViewl); 


// The button is disabled in the layout. 
// It will be enabled upon initialization of the TTS engine. 
mAgainButton = (Button) findViewById(R.id.again button); 


mAgainButton.setOnClickListener(new View.OnClickListener() ( 
public void onClick(View v) ( 
sayHello(); 


n: 


@Override 
public void onDestroy() { 
// Don't forget to shutdown! 
if (mTts != null) { 
mTts.stop(); 


mTts.shutdown(); 








super.onDestroy():; 


// Implements TextToSpeech.OnInitListener. 
public void onInit(int status) { 
// status can be either TextToSpeech.SUCCESS or TextToSpeech.ERROR. 
if (status == TextToSpeech.SUCCESS) { 
// Set preferred language to US english. 


// Note that a language may not be available, and the result will indicate this. 


int result = mTts.setLanguage (Locale.US); 

// Try this someday for some interesting results. 

// int result mTts.setLanguage (Locale.FRANCE); 

if (result == TextToSpeech.LANG MISSING DATA || 
result == TextToSpeech.LANG NOT SUPPORTED) { 
// Lanuage data is missing or the language is not supported. 
Log.e(TAG, "Language is not available."); 

) eise ( 
// Check the documentation for other possible result codes. 
// For example, the language may be available for the locale, 
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在 这 段 内 码 中 : 


HELLOS 数组 中 存放 了 用 于 播放 的 文本 ， 读 者 如 果 想 播放 自己 的 文本 ， 只 需要 蔡 换 该 数组 内 
的 字符 串 即 可 。 


创建 了 TextToSpeech 实例 mTts， 该 构造 方法 的 第 一 个 参数 表示 容纳 该 对 象 的 容器 ,第 二 个 参 
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数 表示 实现 文本 语音 回调 接口 TextToSpeech.OnImitListener 的 类 ， 该 接口 提供 一 个 public void 
onlnit(int status) 方 法 ， 用 于 对 文本 语音 API 进行 初始 化 。TextToSpeech 实例 通过 speak 方法 即 可 进 
行 语音 播放 。 本 实例 是 以 随机 顺序 播放 HELLOS 中 的 字符 串 的 。 

目前 ， 该 功能 对 英文 支持 较 好 ， 暂 不 支持 中 文 文本 播放 。 





13.4 TV 应 用 


电视 应 用 和 和 手机、 平板 使 用 相同 的 结构 ， 这 意味 着 调整 已 有 的 应 用 程序 就 可 以 运行 在 电视 设 
备 或 安 卓 应 用 上 。 但 是 需要 注意 的 是 , 已 有 的 应 用 程序 必须 满足 一 些 要 求 , 才能 够 获得 在 谷歌 应 用 
商店 上 架 的 权利 。 

本 节 主 要 描述 创建 电视 应 用 的 开发 环境 以 及 如 何 将 现 有 的 应 用 程序 进行 最 小 的 修改 ， 使 得 该 
应 用 能 够 在 电视 应 用 上 运行 。 








13.4.1 创建 电视 应 用 项 目 


要 建立 电视 版 应 用 ， 需 要 满足 以 下 几 点 : 

更 新 SDK 工具 到 24.0.0 及 以 上 版 本 。 

更 新 SDK 工具 包 ， 启 动 、 创 建 并 测试 可 穿戴 应 用 .。 
S3 px SDK f| 7.0 (API24) 及 以 上 版 本 。 
更 新 平台 版 本 ， 为 电视 应 用 提供 新 的 API。 

拥有 创建 或 者 更 新 的 应 用 项 目 。 


创建 一 个 能 够 在 电视 设备 上 运行 的 应 用 ， 还 需要 使 用 以 下 元 素 : 
CL) 应 用 于 电视 的 活动 (Activity for TV) 
该 元 素 是 必须 使 用 的 ， 需 要 在 应 用 程序 清单 上 声明 一 个 能 够 在 电视 设备 上 运行 的 活动 。 
(2) 电视 支持 库 (TV Support Libraries) 
该 元 素 是 可 选 的 ， 支 持 库 为 电视 设备 建立 用 户 接口 的 小 部 件 提供 支持 。 
为 了 能 够 使 用 新 的 电视 设备 的 API， 必 须 针对 Android N CAPI 等 级 24) 及 以 上 版 本 创建 一 个 
新 的 项 目 或 者 修改 一 个 已 有 的 项 目 。 
(1) 声明 一 个 TV Activity 
运行 在 电视 设备 上 的 应 用 必须 在 Manifest 中 为 Activity 匹配 android.intent.category. 
LEANBACK LAUNCHER 意图 过 滤器 (Intent Filter) 。 添 加 过 滤器 的 目的 主要 是 为 了 Google Play 
的 识别 ， 没 有 添加 相应 过 滤器 的 应 用 ，Google Play 是 不 允许 上 架 的 。 
以 下 代码 段 用 于 实现 如 何 使 用 这 个 过 滤器 : 


<application 
android:banner="@drawable/banner" > 


<activity 
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android:name-"com.example.android.MainActivity" 


android:label-"6string/app name" > 


<intent-filter> 
<action android:name-"android.intent.action.MAIN" /> 
«category android:name="android.intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 


<activity 
android:name="com.example.android.TvActivity” 
android: label="@string/app_ name" 
android: theme="@style/Theme.Leanback"> 


<intent-filter> 

<action android:name-"android.intent.action.MAIN" /> 

<category android:name-"android.intent.category.LEANBACK LAUNCHER" /> 
</intent-filter> 


</activity> 
</application> 
本 例 中 第 二 个 <activity> 活 动 应 用 清单 入 口 声明 能 够 打开 一 个 电视 设备 的 活动 。 
需要 注意 的 是 ， 如 果 应 用 的 过 滤器 中 不 包括 CATEGORY LEANBACK LAUNCHER， 那 么 用 
户 在 电视 设备 上 运行 谷歌 应 用 商店 时 是 看 不 到 该 应 用 的 ， 同 时 使 用 开发 者 工具 加 载 一 个 电视 设备 
时 ， 如 果 该 应 用 没有 这 个 过 滤器 ， 这 个 应 用 也 不 会 出 现在 电视 用 户 接口 中 。 
如 果 修 改 一 个 已 有 的 应 用 在 电视 应 用 中 使 用 ， 电 视 应 用 上 的 布局 不 同 于 手机 或 平板 电脑 。 电 
视 应 用 的 用 户 接口 (或 者 是 已 存在 的 电视 应 用 的 一 部 分 ) 应 当 提 供 一 个 简单 的 接口 ， 这 个 接口 可 以 
非常 简单 地 使 用 遥控 器 进行 遥控 。 
关于 设计 一 个 电视 应 用 的 指导 ， 请 查看 TV Design。 关 于 电视 布局 最 低 运行 要 求 的 相关 信息 ， 
请 查看 Building TV Layouts。 
(2) 声明 Leanback 技术 支持 
安 卓 电视 要 求 应 用 声明 Leanback 接口 。 如 果 开 发 的 应 用 打算 应 用 在 各 个 移动 设备 (如 手机 、 
可 穿戴 设备 ,平板 电脑 等 ) 上 , 那么 要 将 Leanback 的 required 的 属性 值 设置 为 false. 如果 将 required 
的 属性 值 设置 为 tue， 应 用 将 只 能 运行 在 使 用 Leanback 的 设备 上 。 其 代码 如 下 : 
<manifest> 
<uses-feature android:name-"android.software.leanback" 
android:required-"false" /> 
en 
G) 声明 触摸 屏 的 值 为 false 
电视 设备 上 的 应 用 不 依赖 于 触摸 屏 进 行 输入 。 为 了 让 大 家 更 加 清楚 这 一 点 ， 在 电视 应 用 的 应 用 程 
序 清单 上 ，android hardwaretouchscreen 的 值 设 为 false。 这 个 赋值 说 明 应 用 能 够 运行 在 电视 设备 上 ， 在 
谷歌 的 应 用 商店 才 会 被 视 为 一 个 电视 应 用 。 以 下 代码 给 出 了 android hardware.touchscreen 的 用 法 。 
<manifest> 


«uses-feature android:name-"android.hardware.touchscreen" 


android:required-"false" /» 
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</manifest> 





在 应 用 程序 清单 中 必须 像 上 面 的 代码 中 那样 ， 声 明 应 用 不 需要 使 用 触摸 屏 ， 否 则 应 用 将 不 
会 出 现在 谷歌 应 用 商店 里 。 





(4) 提供 一 个 主屏 幕 banner 
应 用 必须 为 每 个 包含 Leanback 桌面 过 滤器 的 本 地 化 提供 一 个 主屏 幕 banner。 
banner 指出 应 用 运行 时 将 会 出 现 的 应 用 主屏 幕 和 游戏 行 。 在 Manifest H, banner 的 代码 如 下 : 


<application 





android:banner="@drawable/banner" > 


i 

<application> 标签 中 的 android:banner 属性 设置 了 所 有 应 用 活动 的 默认 banner， 也 可 以 在 
<activity> 标签 中 应 用 一 个 特定 活动 的 banner。 

更 多 banners 信息 可 以 在 UI Pattems for TV design guide 中 查找 。 


13.4.2 添加 TV 支持 库 


为 了 在 电视 上 使 用 ， 安 卓 SDK 包括 TV Support Libraries， 这 些 Support Libraries 提供 API 和 
用 户 接 口 组 件 ， 它 们 被 放 在 <sdk>/extras/android/support/ 文 件 夹 下 。 以 下 是 主要 的 库 及 其 功能 。 

© v17 leanback library 

该 库 为 电视 版 应 用 提供 接口 组 件 ， 尤 其 为 那些 媒体 回放 的 应 

(2) v7 recyclerview library 

该 库 提供 管理 内 存 中 存放 的 长 列表 的 高 效 方式 的 类 。 在 v17 leanback 库 中 的 类 依赖 于 该 库 中 的 类 。 

(3) v7 cardview library 

该 库 为 展示 信息 卡 提 供用 户 接口 的 小 部 件 ， 比 如 媒体 缩 略 图 和 描述 等 。 














电视 应 用 中 不 是 必须 使 用 这 些 支持 库 ， 只 是 建议 大 家 使 用 ， 特 别 是 为 提供 媒体 素材 库 浏览 
接口 的 应 用 使 用 。 





使 用 v17 leanback 库 时 ， 需 要 注意 的 是 ， 它 依赖 于 v4 支持 库 。 这 意味 着 使 用 leanback 支持 库 
的 应 用 应 该 包含 以 下 所 有 的 支持 库 : 


* v4 support library 











K 





* v7 recyclerview support library 
* v17 leanback support library 
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v17 leanback 包含 应 用 项 目 中 需要 特定 步骤 的 资源 。 


13.4.3 建立 TV 应 用 


完成 前 两 步 之 后 ， 就 可 以 开始 为 大 屏幕 建立 应 用 了 。 电 视 应 用 分 为 以 下 几 种 : 

e ”建立 电视 回放 应 用 

电视 是 用 来 娱乐 的 ， 所 以 安 卓 提供 了 一 系列 用 户 接口 工具 和 小 部 件 ， 使 建立 的 电视 版 应 用 能 
够 欣赏 影片 和 音乐 ， 使 用 户 能 够 浏览 到 想 要 的 内 容 。 

日 ”帮助 用 户 查 找 内 容 

因为 所 有 的 内 容 都 在 用 户 的 手指 间 ， 所 以 帮助 他 们 选择 喜欢 的 内 容 和 提供 给 他 们 内 容 一 样 重 
要 。 这 里 就 是 讨论 如 何在 电视 设备 上 找到 喜欢 的 内 容 。 
e 电视 游戏 
电视 设备 是 非常 好 的 游戏 平台 。 基 于 Android TV 的 电视 游戏 具有 广阔 的 发 展 空间 。 








13.4.4 运行 TV 应 用 


运行 应 用 在 开发 过 程 中 是 一 个 非常 重要 的 过 程 。 

Android SDK 中 的 AVD 管理 器 提供 了 设备 定义 ， 它 允许 创建 虚拟 电视 设备 、 运 行 和 测试 应 用 
程序 。 

创建 虚拟 电视 设备 需要 以 下 4 个 步骤 : 

ED 打开 安 卓 虚拟 设备 管理 器 。 

CMe 在 安 卓 虚拟 设备 管理 器 对 话 框 中 ， 点 击 “ 设 备 定义 (Device Definitions) ”标签 。 

EIn 选择 一 个 安 卓 电视 类 型 ， 点 击 “ 创 建安 卓 虚 拟 设备 (Create AVD)". 

Eo 选择 模拟 器 选项 ， 点 击 OK 按钮 创建 安 卓 虚拟 机 。 


创建 电视 AVD 的 界面 如 图 13.4 所 示 。 注 意 : 为 了 使 电视 模拟 器 设备 达到 最 好 的 效果 ， 最 好 
能 够 使 用 主机 的 GPU 选项 ， 这 样 可 以 为 虚拟 设备 加 速 。 创 建 的 TV AVD 如 图 13.5 所 示 。 

要 测试 虚拟 设备 上 的 应 用 ， 需 要 两 个 步骤 : 

Cor 在 开发 环境 中 编译 电视 应 用 。 

CH? 在 开发 环境 中 运行 应 用 ， 选 择 电视 虚拟 设备 作为 目标 设备 。 
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图 13.4 创建 TVAVD 























图 13.5 TVAVD 


13.4.5 TV 应 用 实例 


实例 TvDemo 演示 了 开发 电视 应 用 的 基本 过 程 。 该 实例 完成 了 在 电视 上 对 三 个 ImageButton 
的 导航 效果 ， 当 图 像 按键 获得 焦点 时 会 变 大 ， 其 运行 效果 如 图 13.6 所 示 。 


E 5556Tvo - — 








图 13.6 TvDemo 的 运行 效果 
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为 符合 Google Play Store 的 商品 规范 , 需要 首先 为 TvDemo 应 用 程序 取消 触摸 屏 支 持 。 在 该 工 
程 的 AndroidManifestxml 文件 中 加 入 : 


<uses-feature android:required-"false" android:name-"android.hardware.touchscreen"/» 





为 了 能 够 将 该 应 用 显示 到 电视 的 App 列表 中 ， 需 要 在 该 工程 的 启动 Activity 的 过 滤器 中 添加 
如 下 代码 : 


<category android:name="android.intent.category.LEANBACK LAUNCHER" /> 


添加 后 ，TvDemo 就 会 出 现在 电视 的 App 列表 中 ， 如 图 13.7 所 示 





图 13.7 电视 的 App 列表 
该 工程 的 Manifest 文件 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"introduction.android.tvdemo" 





android:versionCode-"1" 
android:versionName-"1.0" » 
«uses-sdk 


android:minSdkVersion- 
android:targetSdkVersion-"22" /» 





<uses-feature android:required-"false" android:name-"android.hardware.touchscreen"/» 
«application 
android:allowBackup-"true" 
android:icon-"Gdrawable/ic launcher" 
android: label="@string/app_name" 
android: theme="@style/AppTheme" > 
<activity 
android:name-".MainActivity" 
android:label-"estring/app name" > 
<intent-filter> 
<action android:name-"android.intent.action.MAIN" /> 
«category android:name-"android.intent.category.LEANBACK LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 


</manifest> 


其 布局 文件 activity main.xml 的 代码 如 下 : 


<RelativeLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
xmlns:tools="http: //schemas.android.com/tools" 
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android: layout_width="match_ parent" 
android:layout height-"match parent" 


android:paddingBottom-"Gdimen/activity vertical margin" 
android:paddingLeft="@dimen/activity horizontal margin" 
android:paddingRight="@dimen/activity horizontal margin" 
android:paddingTop-"6dimen/activity vertical margin" 
tools:context-"introduction.android.tvdemo.MainActivity" 


«ImageButton 
android: id="@+id/imageButton3" 
android: layout_width="wrap content" 
android: layout_height="wrap_ content" 


android: layout_alignTop="@+id/imageButton2" 


android: layout_marginLeft="90dp" 


android: layout_toRightOf="@t+id/imageButton2” 


android:nextFocusDown="@+id/imageButton1" 
android:src-"Gdrawable/ic launcher" /> 


<ImageButton 
android: id="@+id/imageButton1” 
android: layout_width="wrap_ content" 
android:layout height-"wrap content" 
android:layout alignParentLeft-"true" 
android:layout alignParentTop-"true" 
android:layout marginLeft-"39dp" 
android:layout marginTop-"51dp" 
android:nextFocusDown="@+id/imageButton2" 
android:src-"Gdrawable/ic launcher" /> 


<ImageButton 
android: id="@+id/imageButton2" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 


android: layout_alignTop="@+id/imageButton1" 


android: layout_marginLeft="69dp" 


android: layout_toRightOf="@+id/imageButton1" 


android: nextFocusDown="@+id/imageButton3" 
android:src-"Gdrawable/ic launcher" /> 


</RelativeLayout> 





布局 中 的 三 个 ImageButton 默认 情况 下 可 以 通过 电视 的 方向 键 进行 焦点 的 转换 。 本 实例 中 通过 
“android:nextFocusDown ”属性 为 三 个 图 像 按 键 添加 按 下 按键 焦点 循环 改变 的 功能 。 读 者 可 以 通过 


相关 属性 直接 改变 应 用 程序 中 的 导航 效果 。 
FL Activity 的 Java 类 代码 如 下 : 


package introduction.android.tvdemo; 


import android.app.Activity; 

import android.os.Bundle; 

import android.view.Menu; 

import android.view.MenuItem; 

import android.view.View; 

import android.view.View.OnFocusChangeListener; 
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iv. 


表示 图 





13.5. 


@Override 

public boolean onCreateOptionsMenu(Menu menu) { 
// Inflate the menu; this adds items to the action bar if it is present. 
getMenuInflater().inflate(R.menu.main, menu); 
return true; 


@Override 
public boolean onOptionsItemSelected(MenuItem item) { 
// Handle action bar item clicks here. The action bar will 
// automatically handle clicks on the Home/Up button, so long 
// as you specify a parent activity in AndroidManifest.xml. 
int id item.getItemId(); 
if (id == R.id.action_settings) { 
return true; 





} 
return super.onOptionsItemSelected (item); 


中 的 代码 段 : 


1.setOnFocusChangeListener (new OnFocusChangeListener() { 
@Override 
public void onFocusChange (View v, boolean hasFocus) { 
// TODO Auto-generated method stub 
ivl.setScaleType (ScaleType.CENTER) ; 
if (hasFocus) { 
ivl.setScaleX(1.3f); 
ivl.setScaleY(1.3f); 
jJelse( 
ivl.setScaleX(1.0f); 
ivl.setScaleY(1.0f); 


像 按键 1 获得 焦点 后 即 调用 onFocusChange 方法 进行 处 理 。 具 体 的 处 理 方法 为 改变 按键 的 显 


为 原来 的 1.3 倍 ， 即 增 大 显示 。 


13.5 “可 穿戴 设备 应 用 


1 可 穿戴 设备 应 用 简介 


穿戴 式 智 能 设备 是 应 用 穿戴 式 技术 对 日 常 穿 戴 进 行 智能 化 设计 、 开 发 可 穿戴 设备 的 总 称 ， 如 


眼镜 、 村 





、 手 表 、 服 饰 及 鞋 等 。 





广义 的 穿戴 式 智能 设备 不 仅 包括 功能 全 、 尺 寸 大 、 可 不 依赖 智能 手机 实现 完整 或 者 部 分 功能 
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的 设备 ， 如 智能 手表 或 智能 眼镜 等 ， 也 包括 只 专注 于 某 一 类 应 用 功能 ， 需 要 和 其 他 设备 (如 智能 
BL) 配合 使 用 的 设备 ， 如 各 类 进行 体征 监测 的 智能 手 环 、 智 能 首饰 等 。 随 着 技术 的 进步 以 及 用 户 需 
求 的 变迁 ， 可 穿戴 式 智能 设备 的 形态 与 应 用 热点 也 在 不 断 变 化 。 

穿戴 式 技术 在 国际 计算 机 学 术 界 和 工业 界 一 直 备 受 关注 ， 只 不 过 由 于 造价 成 本 高 和 技术 复杂 ， 
很 多 相关 设备 仅仅 停留 在 概念 领域 。 随 着 移动 互联 网 的 发 展 、 技 术 进步 和 高 性 能 低 功 耗 处 理 芯 片 的 
推出 等 , 部 分 穿戴 式 设备 已 经 从 概念 化 走向 商用 化 , 新 式 穿戴 式 设备 不 断 传 出 , 谷歌 、 苹 果 、 微软、 
索尼 、 奥 林 巴 斯 、 摩 托 罗拉 等 诸多 科技 公司 也 都 开始 在 这 个 全 新 的 领域 深入 探索 。 

谷歌 的 Android 系统 在 全 球 的 智能 手机 市 场 已 经 占据 统治 地 位 。 然 而 ,谷歌 并 不 满足 于 此 ,其 
将 新 的 发 展 目标 锁定 在 可 穿戴 式 设备 。 

Android studio 0.8.12 和 Gradle 0.12+ 的 可 穿戴 应 用 程序 可 以 在 可 穿戴 设备 上 直接 运行 , 可 以 直 
接 对 传感器 等 低级 别 硬件 、Activity、 网 络 服 务 器 进行 访问 。 

可 穿戴 应 用 必须 有 一 个 智能 手机 或 者 手持 设备 配合 应 用 ， 才 可 以 提交 到 Google Play 市 场 上 。 
用 户 下 载 手机 应 用 ,自动 把 可 穿戴 应 用 推送 到 可 穿戴 设备 上 , 同时 手机 应 用 伴侣 能 承担 更 重 的 计算 
任务 、 网 络 操作 等 ， 并 发 送 结果 给 可 穿戴 应 用 。 








13.5.2 Android Wear 项 目 搭建 


Android Wear 是 连接 安 卓 手机 和 可 穿戴 产品 的 一 个 平台 。 自 发 布 以 来 ，Android Wear 获得 了 
大 量 关注 ， 既 有 来 自 消费 者 的 关注 ， 也 有 来 自 开 发 商 的 关注 。Android Wear 旨 在 为 用 户 在 对 的 时 间 
提供 数量 合适 的 信息 。 据 此 ， 谷 歌 已 经 发 布 了 设计 原则 以 帮助 开发 商 集中 思考 Android Wear 应 用 
程序 。 

使 用 Android Wear 需要 完成 以 下 三 步 : 

ED) 搭建 Android 开发 环境 ， 更 新 SDK. 

Eo 安装 来 自 谷歌 应 用 程序 市 场 的 Android Wear 应 用 。 

E 匹配 安 卓 手 机 设备 与 Android Wear 设备 。 


下 面 简单 介绍 如 何 建 立 一 个 设备 或 模拟 器 创建 一 个 项 目 。 
1. 搭建 Android 开发 环境 ， 更 新 SDK 


由 于 Android Wear 要 求 Android SDK 的 版 本 至 少 是 4.3, 因此 在 开始 创建 可 穿戴 应 用 之 前 ， 必 
须 完成 以 下 几 项 : 
(1) 更 新 SDK 工具 到 23.0.0 或 者 更 高 版 本 。 
QD 更 新 SDK 工具 包 ， 启 动 、 创 建 并 测试 可 穿戴 应 用 。 
© 更 新 安 卓 SDK 到 7.0 (API 24) 或 者 更 高 版 本 。 
(2) 更 新 平台 版 本 , 为 可 穿戴 应 用 提供 新 的 API, 如 图 13.8 所 示 。 其 中 ,“Android Wear ARM 
EABI v7a System Image” 和 “Android Wear Intel x86 Atom System Image” 必 须 下 载 ， 否 则 无 法 完成 
对 虚拟 设备 的 仿真 。 
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A sdk ©) Appearance & Behavior > System Settings » Android SDK 
v Appearance & Behavior Manager for the Android SDK and Tools used by Android Studio 
, mace Android SDK Location: | F:\Android\Sdk ] Edit 


EE c ri 





Each Android SDK Platform package includes the Android platform and sources pertaining to an APT 





’ png level by default. Once irstaled, Android Studio wil automatically check for updates. Check “show 
pre c | Package details to display indvidual SDK components. 
Name API Level | Revision | 
(C) Google APis Intel x86 Atom 64 System Image 25 3 
(C) Google Play Intel x86 Atom System Image 25 9 
* [© Android 70 (Nougat) 
O Google Apie 24 1 





回 Android SDK Piatform 24 24 2 
C) Sources for Androi 





| 口 























ste 7 
(ARM EABI v7a System Image 24 T 
C] Intel x85 Atom System Image 24 8 
C Intel x85 Atom 64 System Image 24 H 
(C) Google APIs ARM 54 v8a System Image 24 2 Not installed 
C) Google APIs ARM EABI v7a System Image 24 z Not installed 
C] Google APIs Intel x86 Atom System Image 24 z Not installed 
[C Google APIs Intel x86 Atom 64 System Image 24 z Not installed 
C Google Play Intel x86 Atom System Image 24 19 Not installed 
* C Android 60 (Marshmallow) 
C) Google APIs 23 1 Not installed 
C Android SDK Piatform 23 23 3 Not installed 
| LC] Sources for Android 23 2 1 Not installed 
| [C] Android TV ARM EABI v7a System Image 23 n Not installed 











Show Package Details 


WEN ce) Loe) Live | 














图 13.8 更 新 SDK 
2. 创建 Android Wear 模拟 器 


建议 用 户 使 用 真实 设备 ， 这 样 可 以 更 好 地 实现 用 户 体验 测试 。 但 模拟 器 可 以 测试 多 种 设备 ， 


使 用 方便 ， 在 开发 调试 中 也 是 必 不 可 少 的 。 
创建 Android Wear 模拟 器 ， 如 图 13.9 所 示 ， 步 又 如 下 : 











© Android Wear Square 





Category | Name co Size EXT 
ES 
ram Android Wear Round Chin. B 165 — 290... tvdpi 
Size: small 


Android Wear Round B i65 — 320.9 hdpi hae noo 


Tablet 1er 2800x 





| New Hardware Profile | | Import Hardware Profiles 


Le 























图 13.9 创建 AVD 
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€30) 单 击 “Tools | Android | AVD Manager”. 
€o SH "Create Virtual Device....", FF FR, 


© 在 目录 列表 中 单 击 “Wear”。 

© 由 选 定 的 设备 类 型 确定 “Android Wear Square” 或 者 “Android Wear Round" . 
© 单 击 “Next” 按 钮 。 

© 选择 发 布 名 〈 如 Kitkat Wear) 。 

© 单 击 “Next” 按 钮 。 

© 根据 需要 修改 虚拟 设备 (可 选项 ) 。 

C) 单 击 “Finish” 按 钮 完成 。 

CEs 开启 模拟 器 。 


© 选择 刚刚 创建 的 虚拟 设备 。 
Q) 单 击 “Play” 按 钮 。 
@ 等 待 ， 直 到 模拟 器 初始 化 并 显示 Android Wear 桌面 ， 如 图 13.10 所 示 。 








CX304 匹配 手持 设备 和 连接 模拟 器 。 
© 手持 从 谷歌 Play 上 安装 Android Wear 应 用 。 
@ 通过 USB 连接 手持 设备 和 机 器 。 
© 转发 AVD 的 通信 端口 到 连接 的 手机 或 手持 设备 ) ， 在 命令 行 中 输入 如 下 命令 : 
adb -d forward tcp:5601 tcp:5601 
@ 在 手持 设备 上 启动 Android Wear 应 用 后 连接 到 模拟 器 。 
© 点 击 Android Wear 应 用 右上 角 的 菜单 ， 选 择 演示 卡 (Demo Cards) 。 
@ 选择 的 卡片 将 在 模拟 器 的 桌面 以 通知 的 形式 显现 。 
3. 设置 Android Wear 设备 
(1) 在 手机 上 安装 Android Wear 应 用 。 
(2) 遵循 该 应 用 的 指南 为 可 穿戴 设备 配对 手持 设备 ， 测 试 设备 通知 同步 。 
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(3) 保持 手机 上 的 Android Wear 应 用 处 于 打开 状态 。 

(4) 在 安 卓 可 穿戴 设备 上 开启 ADB 调试 。 

(D “settings” 中 选择 “about”。 

@) 单 击 “Build Number”7 下 。 

© 返回 上 一 界面 。 

@ 屏幕 底部 找到 “Developer Options” 开 发 者 选项 。 

© 选择 “ADB Debugging”， 开 启 ADB. 

(5) 通过 USB 连接 可 穿戴 设备 到 机 器 ， 开 发 时 可 直接 把 应 用 安装 到 设备 中 ， 在 可 穿戴 设备 
和 安装 穿戴 应 用 上 会 出 现 一 条 信息 ， 指 示人 允许 调试 。 














如 果 无 法 通过 USB 连接 可 穿戴 设备 到 机 器 ， 请 参看 Debugging over Bluetooth, 





(6) 在 Android Wear 应 用 上 选择 “Always allow from this computer” 后 点 击 “OK” 按 钮 。 

Android Studio 上 的 安 卓 工具 窗口 显示 可 穿戴 设备 上 的 系统 日 志 。 当 运行 “adb devices ”命令 
时 ， 可 穿戴 设备 会 被 列 出 。 

4. f£ Android Studio 上 创建 Android Wear 项 目 

在 开发 前 , 首先 创建 一 个 包含 可 穿戴 和 手持 应 用 模块 的 项 目 。 在 Android Studio 中 , 点 击 “File 
|New Project”， 然后 遵照 Project Wizard 的 指导 ， 进 行 以 下 操作 : 

€o) 在 “Configure your Project ”窗口 输入 应 用 名 和 软件 包 名 称 。 

€X302 在 “Form Factors” 窗 口 进 行 操作 ， 如 图 13.11 所 示 。 

© Create New Project LONE Se ë eS) 





IX Target Android Devices 





Select the form factors and minimum SDK 


Some devices require additional SDKs. Low API levels target mare devices, but offer fewer API features 
E Phone and Tablet 
‘API 24 Android 7.0 (Nougat! H | 
By targeting API 24 and later. your apo wil run on approximately 8.1% of devices. Help me choose | 
DD Indude Android Instant App support | 
E Wear il 
fi 
| 
| 
| 
i 
! 


‘APL 25x Android 7.1.1 (Nougat) H 
Ow 
19124 did 7 owt 日 


C Android Auto 
C Android Things 
API 24 Android 7.0 (Nougat! H 














ie] EE (onn) [ 69) | 
(EN (0 














图 13.11 Form Factors 
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CD 选中 “Phone and Tablet” 并 选择 “API 24: Android 7.0 (Nougat )”。 
© 选中 “Wear”， 并 选择 “API25: Android 7.1.1 (Nougat )”。 


eon 在 第 一 个 “Add an Activity” 窗 口 ， 为 Mobile 添加 一 个 空白 活动 界面 应 用 (blank 
activity) 。 
CX304 在 第 二 个 “Add an Activity” 窗 口 ， 也 为 Wear 添加 一 个 空白 活动 界面 应 用 。 


当 向 导 程序 结束 时 ，Android Studio 创建 了 一 个 新 项 目 ， 包 含 Mobile 和 Wear 两 个 模块 。 这 样 
就 已 经 有 了 一 个 同时 支持 可 穿戴 设备 和 手持 设备 的 项 目 ， 接 下 来 可 以 创建 活动 (activities) 、 服 务 
(services) 、 自 定义 布局 (custom layouts) 等 。 在 手机 端 已 经 完成 了 大 部 分 工作 ， 比 如 网 络 通信 、 
高 强度 计算 以 及 那些 需要 复杂 交互 的 功能 , 但 完成 这 些 工作 的 时 候 , 通常 需要 同步 通知 可 穿戴 设备 
处 理 结果 。 





Wear 模块 还 包含 一 个 “Hello World” 活 动 ， 根 据 屏幕 圆 形 还 是 方形 来 构建 布局 ， 这 时 可 以 
使 用 WatchViewStub ( 可 穿戴 支持 库 的 一 个 界面 组 件 ) 实现 。 





5. 安装 Android Wear 应 用 


在 开发 时 ， 可 以 使 用 ADB Install 或 者 Android Studio 上 的 “Play” 按钮 ， 像 一 般 移动 应 用 一 
样 ， 直 接 把 应 用 安装 到 可 穿戴 设备 中 。 

发 布 时 ， 需 要 把 可 穿戴 应 用 嵌入 一 个 手机 应 用 中 。 当 用 户 从 Google Play 安装 手机 应 用 时 ， 一 
个 连接 好 的 可 穿戴 设备 将 自动 接收 这 个 可 穿戴 应 用 。 但 需要 注意 的 是 ， 自 动 安装 只 工作 于 App 使 
用 了 发 布 密 钥 (Release Key) 进行 签名 ， 而 不 是 调试 密 钥 (Debug Key) . 

从 “Run/Debug Configuration” 下 拉 菜 单 中 选择 “Wear”， 并 单 击 “Play” 按 钮 ， 程 序 运行 并 
打印 出 “Hello World!” 字 样 。 


6. 包含 正确 的 库 


项 目 向 导 会 将 正确 的 依赖 关系 导入 相应 模块 的 build.gradle 文件 中 。 然 而 ， 这 些 导入 的 依赖 关 
系 并 不 都 是 必需 的 。 

(1) 通知 (Notifications) 

用 户 可 以 在 手机 应 用 上 创建 通知 ， 自 动 同步 到 可 穿戴 应 用 。 只 构建 一 次 通知 就 可 以 呈现 于 多 
种 设备 〈 不 只 是 可 穿戴 设备 ， 还 包括 汽车 和 电视 ) ， 而 不 用 为 不 同 的 设备 参数 分 别 进行 设计 。 

对 于 那些 只 出 现在 可 穿戴 设备 上 的 通知 (由 可 穿戴 应 用 所 发 出 的 通知 ) ， 我 们 只 需要 使 用 标 
准 框架 APIs CAPI Level 20) 即 可 移 除 Mobile 模块 的 依赖 库 。 

(2) 可 穿戴 数据 层 (Wearable Data Layer) 

要 通过 可 穿戴 式 数 据 层 APIs 来 同步 发 送 设备 和 手持 设备 之 间 的 数据 , 需要 最 新 版 本 的 Google 
Play 服务 ， 如 果 不 使 用 这 些 API， 这 些 依赖 关系 就 从 模块 中 被 移 除 。 

(3) 可 穿戴 界面 支持 库 (Wearable UI Support Library) 

这 是 一 个 非 官方 的 库 ， 包 括 一 些 专门 为 可 穿戴 设备 设计 的 界面 组 件 ， 这 些 组 件 具 有 很 好 的 实 
践 效果 ， 建 议 在 应 用 中 使 用 。 

这 些 库 只 对 可 穿戴 设备 App 可 用 ， 尽 管 以 后 可 能 会 升级 更 新 ， 但 不 会 影响 应 用 的 使 用 ， 因 为 
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这 些 库 是 被 静态 编译 进 应 用 程序 的 。 使 用 最 新 的 静态 库 并 重新 编译 链接 就 可 以 使 用 最 新 的 特性 。 
13.6 小 结 


本 章 对 与 企业 应 用 开发 相关 的 部 分 内 容 进行 了 简单 介绍 ， 主 要 涉及 设备 管理 API、 文 本 语音 
API、TV 应 用 开发 和 可 穿戴 设备 几 部 分 。 通 过 设备 管理 API， 企 业 可 以 对 智能 设备 进行 较为 严格 
的 管理 , 可 以 制定 企业 对 于 设备 针对 性 的 管理 策略 , 对 手机 进行 定位 、 锁 屏 、 恢复 出 厂 设 置 等 操作 。 
通过 文本 语音 API, 企业 可 以 轻松 地 开发 出 将 文本 转化 为 声音 的 应 用 程序 ,该 功能 对 于 企业 应 用 程 
序 开发 的 多 样 化 有 积极 作用 。 借助 TV 应 用 开发 框架 , 企业 可 以 方便 地 将 自己 的 产品 推广 到 TV 上 。 
而 借助 可 穿戴 设备 应 用 开发 ,可 在 目前 常见 的 智能 手表 、 智 能 手 环 等 可 穿戴 设备 上 开发 自己 的 应 用 。 





应 用 程序 发 布 


在 完成 对 Android 应 用 程序 的 开发 和 测试 工作 后 ， 就 可 以 将 应 用 程序 发 布 出 去 ， 供 用 户 使 用 了 。 

Android 应 用 程序 在 发 布 之 前 ， 需 要 完成 一 系列 工作 。 本 章 以 第 9 章 的 实例 GPSLocationInMap 
为 例 ， 简 单 介 绍 Android 应 用 程序 发 布 过 程 中 相关 的 一 系列 工作 ， 包 括 应 用 程序 发 布 的 步 又、 应 用 
程序 的 签名 、 版 本 定义 等 。 


14.1 应 用 程序 发 布 的 步骤 


一 个 Android 应 用 程序 从 开发 到 发 布 的 过 程 一 般 要 经 过 下 列 步骤 。 


CX 
Cx GE 
C2 ak C) 
t= im 3 
Gis 
E206 
CET 
Exes 
EIo 


完成 开发 工作 ， 在 模拟 器 上 测试 运行 。 

将 应 用 程序 开发 过 程 中 的 调试 信息 移 除 。 
考虑 为 应 用 程序 添加 EULA (End User License Agreement) 。 
为 应 用 程序 添加 自己 的 图 标 ， 取 代 默 认 的 Android 图 标 。 


定义 应 用 程序 的 版 本 。 

为 应 用 程序 进行 签名 。 

如 果 应 用 程序 使 用 了 Google Map API， 需 要 申请 Map API 密 钥 。 
在 真 机 上 测试 运行 。 


测试 完成 后 ， 发 布 到 Google Play Store 或 者 其 他 应 用 程序 网 站 。 


其 中 ， 应 用 程序 的 版 本 由 AndroidManifest.xml 文件 中 的 <Manifese> 标 签 指定 ， 例 如 : 


«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"introduction.android.gpsLocationInMapDemo" 


android:versionCode-"1" 
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android:versionName-"1.0"» 


</manifest> 


其 中 ，android:versionCode 为 一 个 整数 值 ， 代 表 应 用 程序 代码 的 相对 版 本 ， 也 就 是 版 本 更 新 过 
多 少 次 。 该 值 每 次 更 新 的 值 都 应 该 比 前 一 次 大 ， 以 便于 检查 应 用 程序 是 否 需要 升级 ， 此 处 表示 第 一 
次 更 新 。android:versionName 为 一 个 字符 串 值 ， 代 表 应 用 程序 的 版 本 信息 ， 需 要 显示 给 用 户 ， 此 处 
表示 1.0 版 本 。 


142 为 什么 要 为 应 用 程序 签名 


Android 系统 要 求 签名 机 制 ， 所 有 安装 在 Android 系统 上 的 软件 都 必须 经 过 签名 。 与 Symbian 
系统 要 求 对 安装 软件 进行 签名 的 目的 不 同 ，Android 系统 要 求 对 软件 进行 签名 不 是 为 了 获得 软件 在 
Android 系统 上 安装 的 权限 ， 而 是 为 了 用 签名 辨别 软件 的 开发 者 。 

Android 系统 不 会 安装 没有 经 过 签名 的 应 用 程序 ， 所 有 的 Android 应 用 程序 都 要 求 开发 者 使 用 
一 个 证 书 来 进行 签名 。 该 证 书 的 私 钥 由 应 用 程序 的 开发 者 所 拥有 ，Android 系统 通过 该 证 书 来 识别 
应 用 程序 的 开发 者 。 只 有 使 用 同一 个 证 书签 名 的 应 用 程序 ， 才 能 被 Android 系统 允许 进行 升级 、 覆 
盖 安 装 等 操作 。 使 用 不 同 签名 的 两 个 应 用 程序 ， 即 使 其 包 名 和 类 名 完全 相同 ，Android 系统 也 不 会 
允许 其 安装 在 同一 个 目录 下 。 

之 前 的 章节 中 提 到 过 ， 之 前 开发 的 应 用 程序 ， 没 有 经 过 签名 ， 却 可 以 在 模拟 器 上 安装 并 且 运 
行 ， 是 因为 在 开发 模式 下 编译 应 用 程序 的 ADT. 工具 会 自动 使 用 默认 的 证 书 来 对 应 用 程序 进行 签 
名 ， 以 便 其 可 以 在 模拟 器 上 运行 。 单 击 Eclipse 菜单 中 的 Window | Preferences | Android | Build, $è 
示 的 是 系统 默认 的 调试 用 的 签名 数字 证 书 (为 debugkeystore) ， 如 图 14.1 所 示 。 



































"pem = = sic x 
type fiter tert Build e+ ore 
bun ^ | Build Settings: 
p [Zl Automatically refresh Resources and Assets folder on build 
DONE [Z Force error when external jars contain native libraries 
Edo [| Skip packaging and dexing until export or launch. (Speeds up automatic builds on file save) 
Launch Build output 
LogCat @ Silent 
Usage Stats Normal 
Ant - Verbose 
Date Management 
Help Default debug keystore: C:\Users\LB\.android\debug. keystore 
Instal/Update Cacti debug leyan 
Java 
Java EE 
Java Persistence 
JavaScript 
Mylyn u 
Plug-in Development. 
Remote System 
Run/Debug 
Server 
RE oro emm 
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图 14.1 系统 默认 的 数字 签名 
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需要 注意 的 是 ， 使 用 debug keystore 进行 签名 的 应 用 程序 只 能 在 模拟 器 上 运行 ， 而 不 能 在 真 机 
上 运行 。 在 真 机 上 运行 的 应 用 程序 必须 使 用 正式 的 证 书 进行 签名 。 

用 于 给 应 用 程序 签名 的 证 书 不 需要 是 权威 机 构 发 布 的 证 书 ,开发 者 可 以 生成 自己 的 签名 证 书 。 

Android 建议 的 签名 证 书 的 有 效 期 一 般 要 长 于 25 E. Android 系统 只 有 在 应 用 程序 安装 时 才 会 
检查 证 书 的 过 期 时 间 。 若 安装 时 证 书 已 经 过 期 ， 则 应 用 程序 不 能 安装 。 若 在 应 用 程序 安装 后 证 书 过 
期 ， 则 不 会 影响 应 用 程序 的 正常 运行 ， 但 是 会 导致 该 应 用 程序 再 也 不 能 升级 。 

为 应 用 程序 进行 数字 签名 的 过 程 如 下 : 





导出 未 签名 的 应 用 程序 。 
获取 签名 文件 。 
为 应 用 程序 签名 。 


下 面具 体 讲解 数字 签名 的 实现 过 程 。 


14.3 Android 的 签名 策略 


通常 情况 下 ，Android 为 所 有 的 应 用 程序 开发 者 推荐 的 签名 策略 是 ， 所 有 的 应 用 程序 都 应 该 使 
用 同一 个 证 书 进行 签名 ， 并 且 证 书 的 有 效 期 应 该 长 于 应 用 程序 的 生命 周期 。 这 样 做 的 原因 有 以 下 三 


点 : 


应 用 程序 升级 。 若 开发 者 希望 某 应 用 程序 可 以 无 颖 升级 到 新 版 本 ， 则 新 旧版 本 应 用 程序 必须 
使 用 同一 个 证 书 进 行 签名 ， 否 则 不 能 升级 。 如 果 使 用 的 不 是 同一 个 证 书签 名 ， 则 新 的 应 用 程 
序 会 被 安装 到 一 个 完全 不 同 的 目录 下 ， 相 当 于 安装 了 一 个 新 的 应 用 程序 ， 而 旧 的 应 用 程序 不 
能 升级 。 

应 用 程序 模块 化 。Android 系统 允许 多 个 以 同一 个 证 书签 名 的 应 用 程序 运行 在 同一 个 进程 中 ， 
并 将 其 看 作 一 个 应 用 程序 。 每 个 应 用 程序 可 以 以 模块 化 部 署 ， 在 升级 时 可 以 独立 地 升级 其 中 
的 某 一 个 模块 。 

允许 代码 或 者 数据 共享 。Android 提供 了 以 签名 为 基础 的 权限 机 制 ， 应 用 程序 可 以 为 以 相同 
证 书签 名 的 其 他 应 用 程序 公开 自己 的 功能 ， 这 样 就 可 以 在 相同 签名 的 应 用 程序 之 间 共 享 代码 
和 数据 。 


另 一 个 决定 签名 策略 的 重要 因素 是 如 何 设置 签名 密 钥 的 有 效 期 。 


如 果 开 发 者 计划 升级 应 用 程序 ， 那 么 应 该 确保 签名 密 钥 的 有 效 期 超过 应 用 程序 的 生命 周期 。 
Android 建议 密 钥 的 有 效 期 长 于 25 年 。 一 旦 密 钥 过 期 ， 其 签名 的 应 用 程序 将 再 也 无 法 升级 。 
如 果 使 用 同一 个 密 钥 为 多 个 应 用 程序 签名 ， 那 么 密 钥 的 有 效 期 应 该 长 于 其 中 任何 一 个 应 用 程 
序 的 生命 周期 。 

如 果 开 发 者 计划 将 应 用 程序 发 布 到 Android Market 上 ， 那 么 密 钥 的 有 效 期 应 该 超过 2033 年 
10 月 22 日 ， 以 便 保证 应 用 程序 可 以 无 缝 升级 。 
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144 ”导出 未 签名 应 用 程序 





使 用 EclipsetADT 的 方式 开发 应 用 程序 ， 会 使 得 整个 签名 过 程 变 得 简单 。 借 助 于 ADT， 导 出 
未 签名 的 应 用 程序 仅 需 单 击 一 下 即 可 。 


以 实例 GPSLocationInMap 为 例 ， 在 工程 上 右 击 ， 选 择 Android Tools | Export Unsigned 
Application Package 选项 ， 如 图 14.2 所 示 。 


r| JF New Test Project- 


， id New Resource File... 


Alt+ Enter Export Signed Application Package... 
[E Problems| @ Javadoc [i ped _ExPort Unsigned Application Package... 
Display dex bytecode 


图 14.2 Android Tools 子 菜单 


在 弹出 的 对 话 框 中 选择 路 径 ， 单 击 “ 保 存 ” 按 钮 ， 即 可 将 未 经 过 debugkeystore 文件 签名 的 
GPSLocationInMap.apk 保存 起 来 ， 如 图 14.3 所 示 。 
© Export Project 
OO [E « Dita (Q) » book » signedépp 


mi MEHR 
das ^ oe 





了 | 好 用 8 signectop P 
E 人 @ 


大 小 [cd 





DD GPsLocationInMapDemo.apl 18KB 2012-06-10 20: 
stim 


di Windows7.0s ( 
c. IREE E) 

ca IES (F) 

ca BE Gi 

LB 

adta — - 






























































图 14.3 ”保存 数字 签名 
文件 保存 后 ， 会 弹出 一 个 提示 对 话 框 ， 如 图 14.4 所 示 。 


加 Android IDE Plug-in 











An unsigned package of the application was saved at 
@\book\unsignedApp\GPSLocationinMapDemo.apk 


Before publishing the application you will need to: 
- Sign the application with your release key, 
- run zipalign on the signed package. ZipAlign is located in <SDK> /tools/ 


Aligning applications allows Android to use application resources 
more ie fs 





(meram) 








E 


图 14.4 ”提示 对 话 框 
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14.5 ”生成 签名 文件 


生成 Android 签名 证 书 的 方式 有 两 种 : 一 种 是 使 用 ADT 工具 来 生成 签名 证 书 :， 另 一 种 是 使 用 
命令 行 方 式 生 成 签名 证 书 。 








14.5.1 使 用 Android Studio 


€o) 在 Android Studio 工程 界面 ， 选 择 Build | Generated Signed APK 菜单 选项 ， 如 图 14.5 
所 示 。 
Refactor EVE Run Tools VCS Window Help 


e» 4 Make Project Ctrl+F9 y. 
Make Module 'app' 


Clean Project 
Rebuild Project 


Edit Build Types... 

Edit Flavors... r 
Edit Libraries and Dependencies... 
Select Build Variant... F 
Build APK 

Generate Signed APK. 

Analyze APK... 

Deploy Module to App Engine... 





图 14.5 选择 导出 项 目 
ER) 在 Generate Signed APK 对 话 框 中 ， 单 击 Create new.. .按钮 ， 如 图 14.6 所 示 。 


® Generate Signed APK x 

wem [> 
| Greate new... | | Choose existing... 

Key store password: 

Key alias: 

Key password: 


C Remember passwords 


Cee | [nep 
图 14.6 ”生成 秘 钥 文 件 对 话 框 
Ea É New Key Store 对 话 框 中 确定 要 保存 的 key store 文件 的 位 置 和 名 字 ， 并 确定 对 应 的 
key store 文件 的 密码 。 此 处 将 key store 文件 保存 为 “H:\Androidmykeystorejks”， 密 码 为 
“123456”， 如 图 14.7 所 示 。 其 中 ，Alias 为 密 钥 的 别名 ; Validity 为 密 钥 的 有 效 期 ， 建 议 大 于 25 
年 。 所 有 内 容 填 写 完毕 后 ， 单 击 OK 按钮 ，Android Studio 会 在 指定 的 Key store path 路 径 下 生成 秘 
钥 文 件 mykeystorejks， 如 图 14.8 所 示 。 
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® New Key Store x 





Key store path: | H:\android\mykeystore jks 














Password; =e Confirm: | 7777 
Key 
Alias: mykey 
Password: — [e Confirm: [7 (Hj > Android 
Validity (years): | 25 
Certificate 名 称 
Eirstand Last Name: | Lee Bo 
Organizational Unit: | Dep ^ Android Studio 
oe -— | AndroidStudioProjects 
State or Province: — | Liaoning i key 
Country Code (XX): | 86 Z sdk 
EB ee | mykeystore.jks 
图 14.7 创建 密 钥 对 话 框 图 14.8 生成 的 签名 文件 


14.5.2 ”使 用 keytool 命令 


使 用 命令 方式 生成 签名 文件 的 过 程 稍微 复杂 一 点 。 使 用 的 是 keytool 命令 ， 该 命令 位 于 <JDK 
安装 目录 >/bin 文件 夹 下 。 

运行 cmd 命令 ， 输 入 “keytool -help” 命 令 后 按 回 车 键 ， 会 显示 keytool 命令 的 一 系列 参数 的 
用 法 ， 如 图 14.9 所 示 。 


illi CAWindowslsystem32Vcmd.exe © cs 





>keytool -help 


‘changea lia: 














图 149 keytool 命令 
读者 可 以 自己 查阅 帮助 文档 ， 在 此 就 不 一 一 介绍 了 。 
keytool.exe 命令 用 于 生成 密 钥 ， 并 且 把 密 钥 信息 存放 到 keystore 文件 中 。 
运行 命令 行 “keytool -v -genkey -keystore e:\AndroidKey\mykeystore.keystore -alias mykey 
-validity 20000”。 
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其 中 ， 参 数 的 意义 如 下 : 

-v 为 显示 详细 输出 信息 。 

-genkey 为 产生 密 钥 。 

-keystore<keystorefilename>.keystore 指定 生成 keystore 文件 的 文件 名 。 
-alias<keyfilename> 指 定 密 钥 的 别名 。 

-validity<days> 指 定 该 密 钥 的 有 效 期 限 ， 单 位 是 天 。 


该 命令 运行 后 出 现 密 钥 生 成 向 导 ， 开 发 者 根据 要 求 填 写 相应 信息 ， 即 可 生成 密 钥 ， 如 图 14.10 
所 示 。 具 体 步 又 说 明 如 下 : 


输入 keystore 密码 : (MAE “123456” , REAR) 

再 次 输入 新 密码 : (输入 密码 “123456”， 未 回 显 ) 

您 的 名 字 与 姓氏 是 什么 ? 

Unknown]: Lee Bo 

您 的 组 织 单位 名 称 是 什么 ? 

Unknown]:  SIAS 

您 的 组 织 名 称 是 什么 ? 

Unknown]: DEP 

您 所 在 的 城市 或 区 域名 称 是 什么 ? 
Unknown]: Shenyang 

您 所 在 的 州 或 省 份 名 称 是 什么 ? 

Unknown]: Liaoning 

该 单位 的 两 字母 国家 代码 是 什么 ? 

Unknown]: cn 

CN=Lee Bo, OU=SIAS, O-DEP, L-Shenyang, ST-Liaoning, C=cn 正确 吗 ? 

Sh y 

正在 为 以 下 对 象 生成 1,024 位 DSA 密 钥 对 和 自 签名 证 书 (SHAlwithDSA) (有效期 为 20,000 K) : 

CN=Lee Bo, OU=SIAS, O=DEP, L=Shenyang, ST=Liaoning, C=cn 

输入 <mykey> 的 主 密码 (如果 和 keystore 密码 相同 ， 按 回 车 键 ): 

再 次 输入 新 密码 : 〈 输 入 密码 ， 未 回 显 ) 

[正在 存储 e: \AndroidKey\mykeystore. keystore] 











v -genkey -keys e : MindroidKey\nykeys 
aen 














图 14.10 ZAHER F 
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至 此 ， 已 生成 开发 者 签名 证 书 ， 存 储 在 E:\AndroidKey\mykeystore keystore 文件 中 。 开 发 者 可 
以 使 用 该 密 钥 对 应 用 程序 进行 签名 。 


146 ”为 应 用 程序 签名 


有 了 签名 文件 后 ， 就 可 以 为 应 用 程序 签名 了 。 签 名 的 方式 也 分 为 ADT 方式 和 命令 方式 两 种 。 


14.6.1 使 用 Android Studio 


通过 Android Studio 方式 对 应 用 程序 进行 签名 的 过 程 非常 简单 。 

在 Android Studio 工程 中 ， 选 择 Build | Generated Signed APK 菜单 选项 ， 在 弹出 的 对 话 框 中 选 
择 签名 要 使 用 的 秘 钥 文件 ， 然 后 单 击 Next 按钮 。 此 处 在 弹出 的 key store 文件 选择 对 话 框 中 单 击 
Choose existing .…. 按 钮 ， 使 用 14.5.1 节 中 生成 的 mykeystore.jks 文件 ， 如 图 14.11 所 示 ， 并 输入 密码 
“123456” , 


f^ Generate Signed APK 


Key store path: H:\Android\mykeystore.jks 


p 


Key store password: 

Key alias: 

Key password: 

[C Remember passwords 





图 14.11 key store 文件 选择 对 话 框 


在 出 现 的 对 话 框 中 选择 要 存放 签名 APK 的 目标 文件 夹 ， 并 设置 生成 APK 的 方式 是 debug 还 
是 release。 此 处 选择 release 模式 ， 并 单 击 Finish 按钮 ， 如 图 14.12 所 示 。 


® Generate Signed APK x 





Note: Proguard settings are specified using the Project Structure Dialog 
APK Destination Folder: | rojects\Android7\HelloWorld\app | 
Build Type: release B 
Flavors: 








meis | EE (cance) (Hep) 
图 14.12 设置 生成 APK 的 方式 
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Gradle 会 依据 之 前 设置 的 内 容 在 目标 文件 夹 下 生成 签名 
的 APK 文件 ， 如 图 14.13 所 示 ， 签 名 过 程 完成 。 





14.6.2 ”使 用 jarsigner 命令 


使 用 命令 方式 进行 签名 ， 使 用 的 是 jarsigner 命令 ， 该 命 
令 和 keytool 命令 一 梯 被 放置 在 <JDK 的 安装 目录 >\bin 文件 
夹 下 。 

在 cmd 窗口 中 运行 “jarsigner -help” 命 令 ， 显示 该 命令 


的 各 个 参数 的 具体 用 法 如 图 14.14 所 示 ( 在 此 不 一 一 介绍 )。 





fa (E:) > AndroidStudioProjects 


IN 
E 


T build 

- libs 

^ src 

| .gitignore 
app.iml 

Š app-release.apk 
build.gradle 
proguard-rules.pro 








图 14.13 生成 的 APK 文件 








图 14.14 jarsigner 命令 


未 签名 的 APK 文件 使 用 14.4 节 中 导出 的 GPSLocationInMap.apk 文件 。 运 行 cmd 命令 ， 将 命 
令 路 径 设置 到 未 签名 APK 文件 所 在 的 目录 ， 此 处 为 “Q:\bookwnsignedApp”。 签 名 的 证 书 文件 使 
用 14.5.2 节 中 生成 的 签名 文件 ， 保 存 路 径 为 “E:/Androidkey/mykeystore keystore”。 

















使 用 jarsigner 为 GPSLocationInMap.apk 文件 签名 的 


命令 为 “jarsigner -verbose -keystore 











e:/Androidkey/mykeystore.keystore GPSLocationInMapDemo.apk mykey”， 其 中 : 


e -verbose 表示 开启 详细 输出 。 





* -keystore<keystorefilename>.keystore 指定 用 于 签名 的 key store 文件 的 文件 名 。 


* mykey 表示 用 于 签名 的 密 钥 的 别名 。 


运行 结果 如 图 14.15 所 示 。 


输入 密 钥 库 的 口令 短语 (输入 “123456”) 
正在 添加 :META-INF/MANIFEST.MF 
正在 添加 :META-INE/MYKEY .SF 
正在 添加 :META-INF/MYKEY .DSA 
正在 签名 :res/layout/main.xml 
正在 签名 : AndroidManifest.xml 
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正在 签名 : resources.arsc 

正在 签名 : res/drawable-hdpi/ic launcher.png 
正在 签名 :， res/drawable-ldpi/ic launcher.png 
正在 签名 ， res/drawable-mdpi/ic_launcher.png 
正在 签名 : classes.dex 


至 此 ， 完 成 了 对 GPSLocationInMap.apk 的 签名 工作 。 





rn — y 
E C:\Windows\system32\cmd.exe Emm 


Q: Nbookunsig 
bre GPSLocationInMapDem: 














图 14.15 使 用 jarsigner 为 GPSLocationInMap.apk 文件 签名 的 运行 结果 
14.7 ”使 用 zipalign 工具 优化 应 用 程序 


Android SDK 包含 一 个 名 为 zipalign 的 工具 存放 在 tools 文件 夹 下 。 该 工具 能 够 对 打包 的 APK 
应 用 程序 进行 优化 ， 将 资源 文件 对 齐 到 4 字 节 边界 ， 以 加 快 资源 的 读 取 速 度 。 使 用 zipalign 工具 优 
化 过 的 应 用 程序 ， 在 运行 时 可 以 使 Android 与 应 用 程序 间 的 交互 更 加 有 效率 ， 让 应 用 程序 和 整个 系 
统 运行 得 更 快 。 因 此 ， 签 名 的 应 用 程序 在 发 布 之 前 应 该 使 用 zipalign 工具 得 到 优化 后 的 版 本 。 

使 用 ADT 插件 签名 的 应 用 程序 ，Eclipse 会 自动 使 用 zipalign 工具 进行 优化 ， 因 此 不 需要 我 们 
人 工 干预 。 

使 用 命令 方式 签名 的 应 用 程序 ， 需 要 使 用 zipalign 工具 优化 。 优 化 方法 如 下 : 

运行 cmd, 切换 到 签名 的 APK 应 用 程序 所 在 目录 ， 以 14.62 小 节 签 名 的 Q:\book\ 
unsignedApp\GPSLocationInMapDemo.apk 文件 为 例 ， 对 其 优化 需 运 行 如 下 命令 : 


zipalign -v 4 GPSLocationInMapDemo.apk GPSLocationInMapDemo aligned.apk 


EH, -v 表示 开启 详细 输出 ，4 表示 对 齐 字 节 的 个 数 ， 必 须 为 4 才能 起 到 优化 效果 。 该 命令 运 
行 结果 如 下 : 


Verifying alignment of GPSLocationInMapDemo_aligned.apk (4) ... 
50 META-INF/MANIFEST.MF (OK - compressed) 
464 META-INF/MYKEY.SF (OK - compressed) 
946 META-INF/MYKEY.DSA (OK - compressed) 
1784 res/layout/main.xml (OK - compressed) 
2275 AndroidManifest.xml (OK - compressed) 
3076 resources.arsc (OK) 








4476 res/drawable-hdpi/ic launcher.png (OK) 
8508 res/drawable-ldpi/ic launcher.png (OK) 
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10108 res/drawable-mdpi/ic launcher 


12349 classes.dex (OK - compressed) 


Verification successful 


运行 效果 如 图 14.16 所 示 。 


ii C\Windows\system3Acmd.exe 


ook\signedAppY2ipalign 





.png (OK) 








图 


14.16 zipalign 优化 


需要 注意 的 是 ， 该 优化 必须 在 签名 之 后 进行 。 若 先进 行 优化 再 对 APK 文件 进行 签名 ， 会 失去 
优化 效果 。 


14.8 ”发布 到 Google Play Store 


完成 对 APK 文件 的 签名 后 就 可 以 将 应 用 程序 发 布 到 Google 公司 提供 的 网 络 发 布 平台 Google 
Play Store 中 了 ， 如 图 14.17 所 示 。 





图 14.17 





发 布 到 Google Play Store 


Google Play Store ff) LEA http://www.androidcentral.com/google-play-store. 
Google Play Store 原名 Android Market (Android 市 场 ) . Android Market 是 Google 7j Android 


设备 天 


F 发 的 在 线 应 用 程序 商店 。Android j 





机 在 出 厂 时 已 经 预 装 了 Android Market, Android 用 户 可 





以 通过 Android Market 浏览 和 下 载 第 三 方 开发 者 发 布 的 Android 应 用 程序 ， 同 时 也 可 以 将 自己 开发 
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的 应 用 程序 发 布 到 Android Market 上 供 其 他 用 户 下 载 和 使 用 。Google 通过 Android Market 将 全 球 
的 Android 用 户 联系 在 了 一 起 ， 同 时 也 为 Android 用 户 提供 了 创业 的 平台 。 

随 着 Android 系统 本 身 地 位 不 断 攀 升 ， 占 领 全 球 大 部 分 智能 手机 市 场 的 同时 ，Android Market 
却 在 被 快速 边缘 化 ， 于 是 Google 在 Android Market 中 加 入 了 电影 、 电 子 书 和 音乐 〈 部 分 服务 仅 限 
于 美国 地 区 作用 ) 等 服务 ， 丰 富 其 功能 ， 想 让 其 成 为 一 个 超级 市 场 。 

北京 时 间 2012 年 3 月 7 日 凌晨 ，Google 公司 将 Android Market 正式 更 名 为 Google Play Store. 
此 举 则 在 让 消费 者 更 加 清楚 地 认识 到 Google 提供 的 一 系列 广泛 内 容 ， 而 不 只 是 提供 用 于 Android 
智能 手机 和 平板 电脑 的 应 用 以 便 提 升 自身 在 电子 内 容 销售 市 场 上 的 形象 以 及 更 好 地 与 苹果 和 亚 马 
XE. 

对 于 Android 开发 者 来 说 ， 在 Google Play Store 中 注册 后 ， 只 要 一 次 性 支付 25 美元 ， 便 可 成 
X Google Play Store 的 会 员 ， 进 而 可 以 在 该 平台 上 发 布 自己 的 软件 ， 并 可 以 通过 Google Play Store 
提供 的 信息 统计 平台 查看 到 该 软件 被 下 载 、 安 装 、 评 级 等 相关 信息 。 


14.9 小 结 


本 章 简单 介绍 了 Android 应 用 程序 发 布 过 程 中 涉及 的 方法 和 步骤 ， 讲 解 了 对 Android 应 用 程序 
进行 签名 的 重要 性 。 对 Android 应 用 程序 进行 签名 之 前 需要 先生 成 签名 文件 。Android 的 签名 文件 
不 需要 向 权威 机 构 申 请 ， 可 以 由 开发 者 自己 生成 。 生 成 数字 签名 有 两 种 方式 ， 第 一 种 方式 为 使 用 
Android Studio 内 嵌 的 签名 工具 ， 第 二 种 方式 是 使 用 keytool 命令 。 为 应 用 程序 签名 也 有 两 种 方式 ， 
分 别 为 Android Studio 工具 和 jarsigner 命令 。 

Android 应 用 程序 经 过 签名 后 ， 就 可 以 发 布 了 。 目 前 来 讲 ， 最 大 的 Android 应 用 程序 发 布 平台 
为 Google Play Store， 可 以 被 全 世界 的 用 户 直接 访问 。 

希望 读者 能 通过 Google Play Store 赚 到 自己 的 第 一 桶 金 。 


14.10 J 题 


1. Android 应 用 程序 发 布 的 步骤 是 什么 ? 

2. Android 系统 为 什么 要 求 应 用 程序 在 安装 前 必须 被 签名 ? 
3. 怎样 才能 生成 自己 的 签名 文件 ? 

4. 怎样 为 应 用 程序 签名 ? 





